Describe Key
Report a key’s org, scopes, model access and effective limits ([internal]).
Two credentials reach this:
- the rsk_ key itself —
key_idmust equal its own id, and any other value is 404 (never 403), so a data-plane credential is no enumeration oracle; - a management credential (mak_ admin key or user JWT) with keys:read — it reads
any key its scope reaches: an admin key per
_admin_key_reaches, a JWT caller by org role OR as a team admin of the key’s team (allow_team_admin, the same visibilitylist_keysgrants); a key it cannot reach, or an admin key with no access at all, is 403.
The payload is read from a fresh authoritative row: on a warm cache
get_authenticated_key hands back a key_cache reconstruction whose non-projected
columns (meta, carrying label/masked_key) are null.
Authorizations
Headers
Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.
2026-08, 2026-09, 2026-11, 2026-11-12 Response
Successful Response
What the presented key is and may do ([internal]). Carries no secret or hash.