Sessions
Short-lived session token endpoints
Mint a short-lived API token, optionally scoped to a single org
Creates a short-lived JWT off the calling API key. When
organization_id is supplied, the token is pinned to that
org via a scoped_org claim and the org-access middleware
refuses any other org for this token. No new API key row
is created — revoking the parent key invalidates every
session it minted.
A session is meant for use in a browser, so it can do less than its parent key. Within an organization it can use the parent key's permissions on pipelines and their components, secrets, alert rules, tags and logs, but cannot manage API keys, roles, users, child organizations or the organization itself. It cannot mint further sessions or send data to ingest endpoints.
Mint a short-lived API token, optionally scoped to a single org › Request Body
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = object |
Mint a short-lived API token, optionally scoped to a single org › Responses
Session minted
expires_atExpiresAt is the token expiry as an RFC 3339 timestamp.
session_tokenSessionToken is the minted short-lived JWT. Send it as
"Authorization: ApiKey
ttl_secondsTTLSeconds is the effective lifetime applied after clamping.