Notifications

All endpoints operate on the currently authenticated user's notifications. No workspace or space scoping; notifications are user-global.

Base path: /v1/notifications

Endpoints

GET /v1/notifications

List all notifications for the current user, ordered newest first.

Response 200

[
  {
    "id": "uuid",
    "userId": "uuid",
    "title": "Execution failed",
    "body": "Workflow 'Daily Digest' failed at step 3",
    "read": false,
    "createdAt": "2025-01-01T00:00:00Z"
  }
]

PATCH /v1/notifications/read-all

Mark all of the current user's notifications as read.

Response 200

PATCH /v1/notifications/:id/read

Mark a single notification as read.

Response 200: updated notification object

DELETE /v1/notifications/:id

Delete a notification.

Response 204

Notification Object

{
  "id": "uuid",
  "userId": "uuid",
  "title": "string",
  "body": "string",
  "read": false,
  "createdAt": "2025-01-01T00:00:00Z"
}