v1

latestOpenAPI 3.1.02026-07-1245137133.6 KB

notifications

Mark Read

Mark notification events as read for current user.

Provide EITHER notification_ids (list of up to 100 UUIDs) OR before (timestamp). workflow_id filter is only valid with 'before' mode.

Target performance: batch of 100 < 100ms (SC-015).

post/api/v1/notifications/mark-read

unstructured-api-keystring nullable

notification_idsstring[] nullable

Specific notification IDs to mark as read (max 100)

beforestring date-time nullable

Mark all notifications created before this ISO 8601 timestamp as read

mark_allboolean

Mark all unread notifications as read (can combine with workflow_id)

workflow_idstring uuid nullable

Filter by workflow (only valid with 'before' or 'mark_all')

Successful Response

marked_countinteger required

Number of events newly marked as read