SaaSFlow
DevelopersAPIReferencenotifications

Read

Mark one notification as read and return the updated row. Returns 404 if the notification does not exist or the caller cannot read it.

Authentication

Checking whether you're signed in…
PUT
/companies/{companyId}/notifications/{notificationId}/read

Authorization

headerAuthorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

Path Parameters

companyId*string
Length1 <= length
notificationId*string
Length1 <= length

Response Body

Notification marked as read

application/json
  1. response
id*string
Formatuuid
companyId*string
Formatuuid
type*string

The type of notification.

recipientUserId*string

The ID of the user who should receive this notification.

readTime*|

When the notification was read. Null if unread.

Formatdate-time
payload*

Type-specific notification data.

createdTime*|
Formatdate-time
createdUserId*string|null
lastUpdatedTime*|
Formatdate-time
lastUpdatedUserId*string|null
curl -X PUT "https://example.com/companies/string/notifications/string/read"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",  "type": "string",  "recipientUserId": "string",  "readTime": "2019-08-24T14:15:22Z",  "payload": {    "property1": null,    "property2": null  },  "createdTime": "2019-08-24T14:15:22Z",  "createdUserId": "string",  "lastUpdatedTime": "2019-08-24T14:15:22Z",  "lastUpdatedUserId": "string"}