Switch the active organization
POST/v1/me/switch-organization
Mint a new access token scoped to another organization the user is a member of (SPEC-15 §2.7). When the refresh cookie is present, the current refresh session is re-pointed at the target organization so subsequent token refreshes stay in it. 404 when the user is not a member of the target organization.
Request
Responses
- 200
- 400
- 401
- 403
- 409
- 422
- 429
- 500
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Requests-per-second ceiling for the current bucket (per-organization for authenticated calls, per-IP for public ones).
Tokens left in the bucket after this request.
ISO-8601 timestamp when the bucket will be fully refilled.
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Turns consumed by the organization in the current billing period.
Turn ceiling for the organization in the current billing period.
Active relationships currently counted toward the organization’s quota.
Active-relationship ceiling for the organization’s plan.
ISO-8601 timestamp when the current billing period (and the quota) rolls over.
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Requests-per-second ceiling for the current bucket (per-organization for authenticated calls, per-IP for public ones).
Tokens left in the bucket after this request.
ISO-8601 timestamp when the bucket will be fully refilled.
Seconds the client should wait before retrying. Emitted only on 429 responses.
Turns consumed by the organization in the current billing period.
Turn ceiling for the organization in the current billing period.
Active relationships currently counted toward the organization’s quota.
Active-relationship ceiling for the organization’s plan.
ISO-8601 timestamp when the current billing period (and the quota) rolls over.
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).