Skip to content

Mark read notifications

POST /api/v1/notifications/{notificationId}/mark-read: request fields and declared response contract.

POST/api/v1/notifications/{notificationId}/mark-read

Authorization
Permissionnotification.update
Workspace scoperequired
Scope targetworkspace

Parameters

Path parameters
FieldTypeRequiredNullableDefault
notificationIdstringrequirednon-null—

Query parameters: none.

Response

200

Response fields
FieldTypeRequiredNullableDefault
dataobjectrequirednon-null—

Declared failures

Declared failures
NOTIFICATION_MARK_READ_FAILED500 — not retryable

Readback

Read the result back with:

  • notifications.list

Request example

Schematic only. Replace placeholders with real values and include all required nested fields.

POST /api/v1/notifications/{notificationId}/mark-read HTTP/1.1
Authorization: Bearer <token>
x-merulan-workspace-id: <workspace-id>