v1

latestOpenAPI 3.1.02026-07-1245137133.6 KB
notifications

List Notifications

List notification events for the authenticated user.

Returns persisted notification events enriched with per-user read status. Each notification represents a platform event (e.g., job.completed) with an is_read flag indicating whether the current user has marked it as read.

Ordered by created_at DESC with cursor-based pagination.

Args: workflow_id: Filter by workflow ID event_types: Comma-separated event types (e.g., "job.completed,job.failed") since: Filter events created after this ISO 8601 timestamp limit: Max events to return (1-100, default 50) cursor: Pagination cursor from previous response unread_only: Filter to unread events only for current user

get/api/v1/notifications

Query parameters

workflow_idstring uuid nullable
event_typesstring nullable
sincestring date-time nullable
limitinteger
cursorstring nullable
unread_onlyboolean

Headers

unstructured-api-keystring nullable

Response

Successful Response

next_cursorstring nullable

Cursor for next page (null if no more)