Create an endpoint

Create a Frontier Gateway endpoint: a routing slug and the target it points to.

curl

curl --request POST \
  --url https://api.baseten.co/v1/gateway/endpoints \
  --header "Authorization: Api-Key $BASETEN_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "slug": "my-org/glm-5.2",
    "targets": [
      {
        "provider": "BASETEN",
        "model_id": "3kZ9xqd",
        "environment_name": "staging"
      }
    ]
  }'

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

Create an endpoint. An endpoint is a globally-unique routing slug plus the target it points to. Once created, requests that reach the gateway with this slug route to the target you specify. For the conceptual walkthrough, see Endpoints.

Errors

Status	Meaning
400 Bad Request	Invalid payload, slug prefix your organization doesn’t own, duplicate slug, unknown environment, invalid provider-specific target fields, or a targets list that’s empty or has more than one entry.
403 Forbidden	Workspace isn’t onboarded to Frontier Gateway, or the caller doesn’t have management scope.

curl

curl --request POST \
  --url https://api.baseten.co/v1/gateway/endpoints \
  --header "Authorization: Api-Key $BASETEN_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "slug": "my-org/glm-5.2",
    "targets": [
      {
        "provider": "BASETEN",
        "model_id": "3kZ9xqd",
        "environment_name": "staging"
      }
    ]
  }'

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.

Body

application/json

slug · string · required

Globally-unique slug of the form '{org_prefix}/{name}'.

Example:

"baseten/mymodel-4"

targets · EndpointTargetRequestV1 · object[] · required

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

Required array length: 1 element

Show child attributes

Examples:

[
  {
    "environment_name": "staging",
    "model_id": "3kZ9xqd",
    "provider": "BASETEN",
    "target_model": "custom/model-name"
  }
]

[
  {
    "provider": "OPENAI",
    "secret_id": "3kZ9xqd",
    "target_model": "gpt-4o"
  }
]

[
  {
    "base_url": "https://my-vllm.example.com",
    "provider": "OPENAI_COMPATIBLE",
    "secret_id": "3kZ9xqd",
    "target_model": "my-model"
  }
]

region · enum<string> · default: UNRESTRICTED

Region the new routing serves.

Available options: UNRESTRICTED, EU

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