Cowdidocs
API ReferenceNotification Inbox

Mark one notification as unread

POST
/v1/user/notifications/{id}/unread

Authorization

oauth2
AuthorizationBearer <token>

Create a client with POST /v1/oauth/clients, then exchange its credentials for an access token. AUTHORIZATION_CODE clients act on behalf of a signed-in user and always use PKCE; CLIENT_CREDENTIALS clients act as themselves. A client may only be granted scopes its creator already holds — read the grantable list from GET /v1/oauth/clients/scopes.

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/user/notifications/497f6eca-6276-4993-bfeb-53cbbbba6f08/unread"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "title": "string",  "body": "string",  "data": {    "property1": "string",    "property2": "string"  },  "group_key": "string",  "seen": true,  "read": true,  "archived": true,  "seen_at": "2019-08-24T14:15:22Z",  "read_at": "2019-08-24T14:15:22Z",  "archived_at": "2019-08-24T14:15:22Z",  "snoozed_until": "2019-08-24T14:15:22Z",  "severity": "HIGH",  "created_at": "2026-09-01T10:15:30Z"}
{  "code": "BAD_REQUEST",  "description": "Bad Request"}
{  "code": "UNAUTHORISED",  "description": "Unauthorised"}
{  "code": "FORBIDDEN",  "description": "Forbidden"}
{  "code": "RATE_LIMIT_EXCEEDED",  "description": "Too Many Requests"}
{  "code": "INTERNAL_ERROR",  "description": "Internal Server Error"}

Snooze one notification POST

Hides the message from the list and the unread count until `until`. The message comes back unread when that time passes. Returns 400 when `until` is less than 1 minute or more than 90 days after now. Returns 409 when the message is archived.

Unsnooze one notification POST

Brings a snoozed message back to the list now.