POST /v1/auth/refresh
POST/v1/auth/refresh
Exchange the rotating uniqos_refresh cookie for a new access token and a rotated refresh cookie. Replaying an already-rotated token within the rotation grace window re-rotates (rapid-reload race); after the window it revokes the entire session family and returns 401.
Responses
- 200
- 400
- 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).
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).