View a grouped notification after rechecking current access

GET

/v1/admin/me/notifications/history/{batch_id}

• Production
• Local

Clerk identity only. Preferences and devices belong to the person across all current and future organizations. Agent credentials are not accepted. Request bodies are limited to 16 KB. Responses use private, no-store caching.

Authorizations

• ClerkSession
• AgentKey
  account:admin

Parameters

Path Parameters

batch_id

required

string

Responses

200

Success

object

id

required

string

channel

required

string

Allowed values: push email

device_id

string

status

required

string

created_ms

integer format: int64

attempt

integer

items

required

Array<object>

object

id

required

string

notice_id

required

string

kind

required

string

source_id

required

string

source_version

required

integer format: int64

org_id

required

string

project_id

required

string

category

required

string

title

required

string

body

required

Safe summary

string

action_path

required

string

actionable

required

boolean

created_ms

required

integer format: int64

push_status

required

string

Allowed values: off pending sent failed suppressed

email_status

required

string

Allowed values: off pending sent failed suppressed

400

Invalid bounded request

401

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope

reason

Machine-readable quota reason. inbox_limit_exceeded means billing account inbox capacity across all organizations and projects sharing that account; enrollment_token_mailbox_budget_exhausted means the enrollment key lifetime creation allowance. Read message for recovery; inbox counts are separate from sending quotas.

string

used

Consumed plus reserved units.

integer format: int64

delta

Requested additional units.

integer format: int64

limit

integer format: int64

remaining

integer format: int64

consumed

integer format: int64

reserved

integer format: int64

next_reset_at

Next UTC usage-period boundary; pending reservations survive this boundary.

string format: date-time

upgrade_required

boolean

404

Resource not owned or currently accessible

409

Version conflict

429

Test rate limit exceeded

503

Notification dependency unavailable