Skip to main content
GET
Describe Key

Authorizations

Authorization
string
header
required

Enter your MeshAPI key (rsk_...) or, for the admin-keys endpoints, a dashboard session token — sent as Authorization: Bearer <token>.

Headers

X-Mesh-Version
enum<string>
default:2026-08

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.

Available options:
2026-08,
2026-09,
2026-11,
2026-11-12

Path Parameters

key_id
string
required

Response

Successful Response

What the presented key is and may do ([internal]). Carries no secret or hash.

key_id
string
required
label
string | null
required
status
string
required
masked_key
string | null
required
default_model
string | null
required
scopes
string[] | null
required
allowed_models
string[] | null
required
blocked_models
string[] | null
required
model_limits
Model Limits · object | null
required
limits
EffectiveLimits · object
required

Final computed limits applying minimum-wins across key → member → org tiers.