Create an API key

Mint a federated API key under a Frontier Gateway group. The plaintext key is returned exactly once.

curl

curl --request POST \
  --url https://api.baseten.co/v1/gateway/groups/abc123hash/api_keys \
  --header "Authorization: Api-Key $BASETEN_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "prod-key-1"
  }'

200

{
  "api_key": "sky_sCqhBwEy4kPd.<api-key-secret>",
  "prefix": "sky_sCqhBwEy4kPd",
  "name": "prod-key-1"
}

Mint a new federated API key under an existing group. The key inherits the group’s effective model set and limits; the request body does not configure either on the key. The plaintext key is returned exactly once in the response and is unrecoverable afterward.

Errors

Status	Meaning
403 Forbidden	The group exists but isn’t in your workspace, or the caller doesn’t have management scope.
404 Not Found	No group with this id in your workspace, or it has been deleted.

curl

curl --request POST \
  --url https://api.baseten.co/v1/gateway/groups/abc123hash/api_keys \
  --header "Authorization: Api-Key $BASETEN_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "prod-key-1"
  }'

200

{
  "api_key": "sky_sCqhBwEy4kPd.<api-key-secret>",
  "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

Body

application/json

name · string | null

Optional display name for the new key.

Example:

"prod-key-1"

Response

200 - application/json

api_key · string · required

Plaintext key string, returned exactly once.

prefix · string · required

Key prefix (the part before the dot).

name · string | null

Display name of the key.