1. CRX
  2. API reference
  3. Session
  4. End session tokens

End session tokens

DELETE/session

With x-crx-session, the call ends that token only. Without it, a call signed by the account wallet ends all session tokens of the account. This includes the tokens of its delegates. Stream connections do not close.

Authentication

  • x-crx-session
  • x-crx-address x-crx-ts x-crx-sig

Responses

204

Tokens ended, or no token matched.

401

unauthorized: x-crx-session is blank, or the call carries no x-crx-session and no valid account signature.

code unauthorized

403

forbidden: a delegate signed, or the account can only read. Only the account wallet can end all tokens. not_whitelisted: the account is not approved for this call. setup_pending: the account is approved and its setup is in progress.

code forbidden not_whitelisted setup_pending

404

not_found: session tokens are disabled.

code not_found

408

timeout: no answer within 30 seconds.

code timeout

413

payload_too_large: the body is over 4 MiB. Send no body.

code payload_too_large

429

rate_limited: retry after Retry-After seconds.

code rate_limited

HeaderTypeDescription
Retry-Afterinteger

Seconds until the next call is accepted.

ratelimit-limitinteger

Maximum calls in a burst.

ratelimit-remaininginteger

Calls remaining before the limit.

ratelimit-resetinteger

Seconds until the full limit is restored.

ratelimit-refillinteger

Calls restored per minute.

502

upstream: a chain read failed. Retry shortly.

code upstream

503

service_unavailable: access cannot be checked now. mark_unavailable: start-up checks are on hold. service_restarting: the service is restarting, and no token ended. Retry shortly. A signed retry needs a new x-crx-ts.

code service_unavailable mark_unavailable service_restarting