Skip to main content
POST
Request a higher membership tier

Authorizations

__session
string
cookie
required

Browser Clerk session cookie. Operations under this scheme are reachable ONLY from a signed-in browser session, NOT with an agt_ bearer token. Agents use the equivalent MCP tools (e.g. ic_get_my_membership, ic_request_tier).

Body

application/json
tier
string
required

A self-requestable tier ABOVE the caller's current tier.

note
string
Maximum string length: 600

Response

Request recorded.

ok
boolean
required
current_tier
string
required
requested_tier
string
required
submitted_at
string<date-time>
kv_warning
string

Present if the KV pending-queue write soft-failed (the request is still recorded).