Get a notification and mark it as read

Returns the underlying announcement and upserts user_announcement_state.read = true for the current user. The first GET creates the per-user state row. Open to any authenticated user; rate-limited to 100 calls per minute.

GET /v1/notifications/{notificationId}

Get a notification and mark it as read

cURL

curl --request GET \
  --url https://{host}/v2/workspaces/slug:ai-governance-v2/webhooks/v1/notifications/{notificationId} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "<string>",
  "title": "<string>",
  "summary": "<string>",
  "content": "<string>",
  "icon": "<string>",
  "link": "<string>",
  "read": true,
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

BearerAuthOrgApiKeyAuth

Authorization · string · header · required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Path Parameters

notificationId · string · required

Notification identifier - equal to the underlying announcement id (lazy model).

Maximum string length: 64

Pattern: ^[a-zA-Z0-9_-]+$

Response

200

application/json

Notification details with read: true.

Notification details returned by markNotificationRead (includes content).

id · string

type · enum<string>

Available options: announcement

title · string

summary · string

content · string

icon · string

link · string

read · boolean

createdAt · string<date-time>