/v1/gateway/ and are gated to Frontier Gateway workspaces. Authenticate with a workspace API key with management scope, passed as Authorization: Api-Key $BASETEN_API_KEY. Requests from workspaces that aren’t onboarded return 403. The full OpenAPI spec is available at api.baseten.co/v1/spec for generating API clients.
Endpoints
An endpoint maps a routing slug to the deployment that serves it. Use these routes to create, inspect, re-point, and delete endpoints.| Method | Endpoint | Description |
|---|---|---|
POST | /v1/gateway/endpoints | Create an endpoint |
GET | /v1/gateway/endpoints | List endpoints |
GET | /v1/gateway/endpoints/{endpoint_id} | Get an endpoint |
PATCH | /v1/gateway/endpoints/{endpoint_id} | Update an endpoint |
DELETE | /v1/gateway/endpoints/{endpoint_id} | Delete an endpoint |
Groups
A group owns the model set, rate and usage limits, and place in the hierarchy that its keys inherit. Use these routes to manage groups and inspect their usage.| Method | Endpoint | Description |
|---|---|---|
POST | /v1/gateway/groups | Create a group |
GET | /v1/gateway/groups | List groups |
GET | /v1/gateway/groups/{group_id} | Get a group |
GET | /v1/gateway/groups/{group_id}/usage | Get group usage |
PATCH | /v1/gateway/groups/{group_id} | Update a group |
DELETE | /v1/gateway/groups/{group_id} | Delete a group |
API keys
A federated API key is the credential your customers call with, bound to one group whose limits it inherits. Use these routes to mint, list, and revoke keys.| Method | Endpoint | Description |
|---|---|---|
POST | /v1/gateway/groups/{group_id}/api_keys | Create an API key |
POST | /v1/gateway/groups/{group_id}/api_keys/register | Register an API key |
GET | /v1/gateway/groups/{group_id}/api_keys | List API keys for a group |
GET | /v1/gateway/groups/{group_id}/api_keys/{api_key_prefix} | Get an API key |
DELETE | /v1/gateway/groups/{group_id}/api_keys/{api_key_prefix} | Revoke an API key |