Get an API key

Fetch metadata for one federated API key by its prefix. The plaintext key is never returned after creation.

curl

curl --request GET \
  --url https://api.baseten.co/v1/gateway/groups/abc123hash/api_keys/sky_sCqhBwEy4kPd \
  --header "Authorization: Api-Key $BASETEN_API_KEY"

200

{
  "prefix": "sky_sCqhBwEy4kPd",
  "name": "prod-key-1"
}

Fetch one federated API key by its prefix. Only metadata is returned; the plaintext key is shown exactly once at creation and is unrecoverable afterward. To inspect the model access and limits the key resolves to, fetch its group and read the effective_models block.

Errors

Status	Meaning
403 Forbidden	The group or key exists but isn’t in your workspace, or the caller doesn’t have management scope.
404 Not Found	No group or key with these identifiers in your workspace, or the key has been revoked.

curl

curl --request GET \
  --url https://api.baseten.co/v1/gateway/groups/abc123hash/api_keys/sky_sCqhBwEy4kPd \
  --header "Authorization: Api-Key $BASETEN_API_KEY"

200

{
  "prefix": "sky_sCqhBwEy4kPd",
  "name": "prod-key-1"
}

Authorizations

Authorization · string · header · required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Path Parameters

group_id · string · required

api_key_prefix · string · required

Response

200 - application/json

prefix · string · required

The prefix of the Model API key.

name · string | null

Optional display name.