Skip to main content
POST
/
v1
/
notifications
/
{notification_id}
/
read
curl -X POST https://portal-api.7331.org/v1/notifications/42/read \
  -b "psession=YOUR_SESSION"

{
  "id": 42,
  "title": "Welcome to Portal",
  "body": "Your account has been created.",
  "type": "success",
  "read_at": "2026-04-21T10:30:00Z",
  "created_at": "2026-04-04T10:00:00Z",
  "created_by": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.7331.org/llms.txt

Use this file to discover all available pages before exploring further.

Marks one notification as read. Returns the updated notification on success. The server distinguishes three outcomes via separate HTTP codes — collapsing them into a single 404 or 200 would hide real bugs in the client.

​
Errors

StatusErrorMeaning
404ERR_NOTIFICATION_NOT_FOUNDNo such notification, or not owned by caller
409ERR_NOTIFICATION_ALREADY_READNotification exists and is owned, but was already read
​
notification_id
integer
required
Notification ID (≥ 1).

​
Response

Same shape as the notifications[] entries in List Notifications. 
curl -X POST https://portal-api.7331.org/v1/notifications/42/read \
  -b "psession=YOUR_SESSION"

{
  "id": 42,
  "title": "Welcome to Portal",
  "body": "Your account has been created.",
  "type": "success",
  "read_at": "2026-04-21T10:30:00Z",
  "created_at": "2026-04-04T10:00:00Z",
  "created_by": null
}