Skip to content
KataraKatara documentation

Count unread notifications

GET
/katara/v1/notifications/count
curl --request GET \
  --url 'https://api.katara.com/katara/v1/notifications/count?product=account' \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
org_id
string format: uuid
environment_id
string format: uuid
product
string
Allowed values: account organization billing provider cortex synapse locus

Header Parameters

Section titled “Header Parameters”
X-Katara-Account-ID
string format: uuid
/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/

Optional for reads after sign-in. Use the UUID of the account that loaded the application. A different current cookie account returns account_changed before the handler runs. Session bearer and API key clients do not require this header.

Responses

Section titled “Responses”

200

Section titled “200”

Current notification state.

Media typeapplication/json
object
unread_count
required
integer
<= 1000
has_more
required
boolean
Examplegenerated
{
  "unread_count": 1,
  "has_more": true
}

400

Section titled “400”

Invalid request.

403

Section titled “403”

A current human session or permission is required.

404

Section titled “404”

Item or source access is unavailable.

409

Section titled “409”

The state version changed; reload before editing.