Evenbead docs
Contents

Sessions

3 operations. All areas

POST/v1/sessions

Open a web session with a person's API key (agents cannot). The token is shown once; only its hash is stored. It expires after 8 hours idle or 7 days.

  • Operation createSession
  • Scope: read
  • Write: needs Idempotency-Key (or dry_run)
Request body

Empty object {}.

Responses
  • 201 Opened (object)
  • Errors 400, 401, 403, 409, 422, 429, 500 (Error: error.type, message)

GET/v1/sessions

Your active web sessions

  • Operation listSessions
  • Scope: read
  • Read
Responses
  • 200 Sessions (object)
  • Errors 400, 401, 403, 429, 500 (Error: error.type, message)

POST/v1/sessions/{id}/revoke

Sign a session out (your own; admins: anyone's in the company)

  • Operation revokeSession
  • Scope: read
  • Write: needs Idempotency-Key (or dry_run)
Parameters
  • id path, string, required
Request body
  • reason string
Responses
  • 200 Revoked (object)
  • Errors 400, 401, 403, 404, 409, 422, 429, 500 (Error: error.type, message)