> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baseten.co/llms.txt
> Use this file to discover all available pages before exploring further.
# List endpoints
> List every Frontier Gateway endpoint in your workspace.
List the endpoints in your workspace, each with its slug and configured targets. The response is paginated.
### Query parameters
Page size. Default 100, maximum 1000.
Opaque cursor for the next page, taken from `pagination.cursor` of a previous response. Omit it for the first page.
### Errors
| Status | Meaning |
| --------------- | ------------------------------------------------------------------------------------------- |
| `403 Forbidden` | Workspace isn't onboarded to Frontier Gateway, or the caller doesn't have management scope. |
```bash curl theme={"system"}
curl --request GET \
--url https://api.baseten.co/v1/gateway/endpoints \
--header "Authorization: Api-Key $BASETEN_API_KEY"
```
```bash next page theme={"system"}
curl --request GET \
--url "https://api.baseten.co/v1/gateway/endpoints?cursor=aVd2Yk54T2d2V0dFWE13R1l4R2k5UVE=" \
--header "Authorization: Api-Key $BASETEN_API_KEY"
```
```json 200 theme={"system"}
{
"items": [
{
"id": "abc123hash",
"slug": "my-org/glm-5.2",
"targets": [
{
"provider": "BASETEN",
"model_id": "3kZ9xqd",
"environment_name": "staging"
}
],
"created_at": "2026-06-17T12:00:00Z",
"updated_at": "2026-06-17T12:00:00Z"
}
],
"pagination": {
"has_more": true,
"cursor": "aVd2Yk54T2d2V0dFWE13R1l4R2k5UVE="
}
}
```
## OpenAPI
````yaml get /v1/gateway/endpoints
openapi: 3.1.0
info:
description: REST API for management of Baseten resources
title: Baseten management API
version: 1.0.0
servers:
- url: https://api.baseten.co
security:
- BearerAuth: []
paths:
/v1/gateway/endpoints:
get:
summary: Lists Gateway endpoints
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/EndpointsResponseV1'
x-codeSamples:
- lang: bash
source: |
curl --request GET \
--url https://api.baseten.co/v1/gateway/endpoints \
--header "Authorization: Bearer $BASETEN_API_KEY"
- lang: python
source: |-
import requests
import os
API_KEY = os.environ.get("BASETEN_API_KEY", "")
url = "https://api.baseten.co/v1/gateway/endpoints"
headers = {"Authorization": f"Bearer {API_KEY}"}
response = requests.request(
"GET",
url,
headers=headers,
json={}
)
print(response.text)
components:
schemas:
EndpointsResponseV1:
properties:
items:
description: Items in this page.
items:
$ref: '#/components/schemas/EndpointV1'
title: Items
type: array
pagination:
$ref: '#/components/schemas/PaginationResponseV1'
description: Pagination metadata for the page.
required:
- items
- pagination
title: EndpointsResponseV1
type: object
EndpointV1:
description: >-
A Gateway endpoint: a slug and its priority-ordered targets (index 0
tried first).
properties:
id:
description: Stable identifier for the endpoint.
title: Id
type: string
slug:
description: Globally-unique routing slug.
examples:
- baseten/mymodel-4
title: Slug
type: string
region:
$ref: '#/components/schemas/SharedEndpointRegionV1'
description: Region this endpoint's routing serves.
created_at:
description: Creation time, ISO 8601.
format: date-time
title: Created At
type: string
updated_at:
description: Last update time, ISO 8601.
format: date-time
title: Updated At
type: string
targets:
description: >-
The endpoint's upstream targets. Exactly one target is supported at
this time.
items:
$ref: '#/components/schemas/EndpointTargetV1'
title: Targets
type: array
required:
- id
- slug
- region
- created_at
- updated_at
- targets
title: EndpointV1
type: object
PaginationResponseV1:
properties:
has_more:
description: Whether more items exist after this page.
title: Has More
type: boolean
cursor:
anyOf:
- type: string
- type: 'null'
default: null
description: >-
Opaque cursor to pass into the next request. Null when there is no
next page.
title: Cursor
required:
- has_more
title: PaginationResponseV1
type: object
SharedEndpointRegionV1:
enum:
- UNRESTRICTED
- EU
title: SharedEndpointRegionV1
type: string
EndpointTargetV1:
description: One configured upstream target of an endpoint.
properties:
provider:
$ref: '#/components/schemas/GatewayProvider'
description: Upstream provider.
secret_id:
anyOf:
- type: string
- type: 'null'
default: null
description: Referenced secret, if any.
title: Secret Id
target_model:
anyOf:
- type: string
- type: 'null'
default: null
description: Upstream model name, if any.
title: Target Model
base_url:
anyOf:
- type: string
- type: 'null'
default: null
description: Custom OpenAI-compatible base URL, if any.
title: Base Url
model_id:
anyOf:
- type: string
- type: 'null'
default: null
description: Baseten model, if any.
title: Model Id
environment_name:
anyOf:
- type: string
- type: 'null'
default: null
description: Baseten model environment, if non-production.
title: Environment Name
vertex_config:
anyOf:
- $ref: '#/components/schemas/VertexTargetConfigV1'
- type: 'null'
default: null
description: Google Vertex configuration, if any.
required:
- provider
title: EndpointTargetV1
type: object
GatewayProvider:
description: >-
Customer-facing provider for an endpoint target.
External providers resolve to a fixed upstream host + protocol adapter
via
``external_provider_configs()``; ``BASETEN`` derives its host from the
referenced oracle.
enum:
- ANTHROPIC
- OPENAI
- XAI
- BASETEN
- BASETEN_MODEL_API
- VERTEX
- OPENAI_COMPATIBLE
title: GatewayProvider
type: string
VertexTargetConfigV1:
properties:
project_id:
description: Google Cloud project ID or project number.
examples:
- my-gcp-project
- '464036093014'
title: Project Id
type: string
location:
description: Google Cloud location.
examples:
- global
title: Location
type: string
required:
- project_id
- location
title: VertexTargetConfigV1
type: object
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: >-
Send `Authorization: Bearer `. The legacy `Authorization:
Api-Key ` scheme is also accepted.
````