Mark notification as read

PATCH

/api/v1/notifications/{id}/read

Sets read_at when still unread. Idempotent: if already read, read_at is left unchanged.
Only the owning user may call this endpoint.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Responses

🟢200

application/json

Notification after mark-read (same shape as GET show)

Bodyapplication/json

🟠401Unauthorized

🟠404NotFound

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/api/v1/notifications//read' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "notification": {
            "id": 1,
            "kind": "proposal_accepted",
            "title": "Proposal request accepted",
            "body": "Partner accepted the proposal for your service.",
            "read_at": "2026-04-14T12:30:00.000Z",
            "read": true,
            "notifiable": {
                "type": "Contract",
                "id": 42
            },
            "created_at": "2026-04-14T10:00:00.000Z",
            "updated_at": "2026-04-14T12:30:00.000Z"
        }
    }
}

Modified at 2026-06-08 00:59:16

Get a notification