Skip to content
Extrovert Extrovert Docs

Change one category or grouping interval with optimistic version checking

PATCH
/v1/admin/me/notifications

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

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
expected_version
required
integer
grouping_minutes
integer
Allowed values: 1 5 15
category
string
push
boolean
email
boolean

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Success

object
grouping_minutes
required
integer
default: 5
Allowed values: 1 5 15
version
required
integer
categories
required
Array<object>
object
id
required
string
Allowed values: review purchase_approval purchase_completed purchase_problem domain_progress domain_action domain_ready domain_problem sending_problem
label
required
string
description
required
string
push
required
boolean
email
required
boolean

400

Section titled “400 ”

Invalid bounded request

401

Section titled “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

Section titled “404 ”

Resource not owned or currently accessible

409

Section titled “409 ”

Version conflict

429

Section titled “429 ”

Test rate limit exceeded

503

Section titled “503 ”

Notification dependency unavailable