Get an endpoint

Retrieve a single Frontier Gateway endpoint by its ID.

curl

curl --request GET \
  --url https://api.baseten.co/v1/gateway/endpoints/abc123hash \
  --header "Authorization: Api-Key $BASETEN_API_KEY"

200

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

Retrieve a single endpoint by its id, including its slug and configured targets.

Errors

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

curl

curl --request GET \
  --url https://api.baseten.co/v1/gateway/endpoints/abc123hash \
  --header "Authorization: Api-Key $BASETEN_API_KEY"

200

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

Authorizations

Authorization · string · header · required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Path Parameters

endpoint_id · string · required

Response

200 - application/json

A Gateway endpoint: a slug and its priority-ordered targets (index 0 tried first).

id · string · required

Stable identifier for the endpoint.

slug · string · required

Globally-unique routing slug.

Example:

"baseten/mymodel-4"

region · enum<string> · required

Region this endpoint's routing serves.

Available options: UNRESTRICTED, EU

created_at · string<date-time> · required

Creation time, ISO 8601.

updated_at · string<date-time> · required

Last update time, ISO 8601.

targets · EndpointTargetV1 · object[] · required

The endpoint's upstream targets. Exactly one target is supported at this time.

Show child attributes