v1
latestOpenAPI 3.1.02026-07-1245137133.6 KBnotifications
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