List the caller's notification inbox
Returns the inbox-visible notifications addressed to the caller, newest first, optionally narrowed to one `workspaceId` or to `scope=account`, and to unread only or including archived ones. Any authenticated caller sees only their own notifications; passing `workspaceId` additionally requires `workspace:read` there. Paginated: pass `limit` and the `cursor` taken from the previous response's `nextCursor`. A malformed cursor, a non-integer `limit`, a non-boolean flag, or an unrecognized `scope` is a validation error.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Query Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/notifications"{ "data": { "notifications": [ { "id": "string", "scope": "account", "workspaceId": "string", "recipientUserId": "string", "recipientEmail": "string", "actorUserId": "string", "actorDisplayName": "string", "actorAvatarUrl": "string", "category": "collaboration", "kind": "comment", "title": "string", "body": "string", "target": { "type": "workspace", "workspaceId": "string" }, "action": { "type": "open_target" }, "data": {}, "surfaceId": "string", "itemId": "string", "blockId": "string", "commentId": "string", "preview": "string", "surfaceTitle": "string", "readAt": "string", "archivedAt": "string", "createdAt": "string" } ], "nextCursor": "string" }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}List the items that link to an item
Returns the inbound links to a workspace item — the pages, records, and surfaces whose content references it. Requires an authenticated actor with read access to the item; an unreadable or missing item is reported as not found. Pass `limit` to cap the number of backlinks returned; a non-integer `limit` is rejected as a query validation error.
Count the caller's unread notifications
Returns how many unread, inbox-visible notifications are addressed to the caller, optionally restricted to one `workspaceId`. Any authenticated caller may read their own count; passing `workspaceId` requires `workspace:read` in that workspace.