Skip to content
calternal docs

Get one inbox notice

GET
/api/v1/notifications/inbox/{id}
curl --request GET \
  --url https://example.com/api/v1/notifications/inbox/example \
  --header 'Authorization: Bearer <token>'

Get a notice from the current User inbox. The server checks the notice owner before it returns a destination. Route: /api/v1/notifications/inbox/{id}. Inputs: id. Safe reads can use bounded retries.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json

One inbox item returned to the authenticated User.

object
action_label

Action label for a web toast while its Installation still owns the action.

string | null
body

Optional display detail.

string | null
created_ms
required

Creation time in Unix milliseconds.

integer format: int64
id
required

Stable notification identifier.

string
kind
required

Stable notification category.

string
link

Optional local deep link.

string | null
read_ms

Read time in Unix milliseconds, or null when unread.

integer | null format: int64
reminder_state

Per-User action state for an active block reminder, when this row owns one.

string | null
title
required

Short display title.

string
Examplegenerated
{
  "action_label": "example",
  "body": "example",
  "created_ms": 1,
  "id": "example",
  "kind": "example",
  "link": "example",
  "read_ms": 1,
  "reminder_state": "example",
  "title": "example"
}

400

Section titled “400”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}

401

Section titled “401”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}

403

Section titled “403”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}

404

Section titled “404”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}