Create an API key

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

{
  "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 --request POST \
  --url https://api.baseten.co/v1/gateway/groups/abc123hash/api_keys \
  --header "Authorization: Bearer $BASETEN_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "prod-key-1"
  }'

{
  "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.

⌘I

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

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

Reference

Inference API

Management API

Loops API

Training API

Frontier Gateway API

Sandbox runtime API

CLI reference

SDKs and clients

Configuration

Metrics

Integrations

Create an API key

Errors

Authorizations

Path Parameters

Body

Response