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

{
  "items": [
    {
      "prefix": "aBcDeFg",
      "name": "prod-key-1"
    }
  ],
  "pagination": {
    "has_more": false,
    "cursor": null
  }
}
List the federated API keys minted under a group. Results are cursor-paginated. Per-key responses carry only the prefix and name; to inspect the model access and limits a key resolves to, fetch its group and read the effective_models block.

​
Authentication

​
Authorization
string
required
Workspace API key with management scope, passed as Authorization: Api-Key $BASETEN_API_KEY (or Bearer; both are accepted).

​
Path parameters

​
group_id
string
required
Internal Baseten ID of the group whose keys you want to list.

​
Query parameters

​
limit
integer
Page size. Default 100, maximum 1000.
​
cursor
string
Pagination cursor from the previous response’s pagination.cursor. Omit on the first call.

​
Response

​
items
object[]
required
Key objects. Each item:
  • prefix (string): The key’s prefix.
  • name (string or null): Display name set when the key was minted.
​
pagination
object
required
  • has_more (boolean): true when more pages exist.
  • cursor (string or null): Cursor for the next page. null on the last page.

​
Errors

StatusMeaning
403 ForbiddenThe group exists but isn’t in your workspace, or the caller doesn’t have management scope.
404 Not FoundNo group with this id in your workspace, or it has been deleted.
curl --request GET \
  --url https://api.baseten.co/v1/gateway/groups/abc123hash/api_keys \
  --header "Authorization: Api-Key $BASETEN_API_KEY"

{
  "items": [
    {
      "prefix": "aBcDeFg",
      "name": "prod-key-1"
    }
  ],
  "pagination": {
    "has_more": false,
    "cursor": null
  }
}