Skip to main content
POST
Check API key validity

Authorizations

Authorization
string
header
required

API key for programmatic access (Authorization: Bearer sk-<api_key>)

Response

API key is valid and has sufficient credits

Response from the check_api_key endpoint.

organization_id, workspace_id, and api_key_id are returned so downstream gateways (e.g. inference-proxy) have a server-side authoritative subject identity and don't have to trust caller-supplied headers when populating logs / usage records / billing reports. In particular, this lets a trusted gateway report usage to cloud-api with a shared service token instead of forwarding the user's sk-….

api_key_id
string
required

UUID of the API key itself. Used by trusted gateways to attribute per-key usage rows without holding the raw sk-… value.

organization_id
string
required

Organization the API key belongs to

valid
boolean
required

Whether the API key is valid and authorized

workspace_id
string
required

Workspace the API key belongs to