Retrieve endpoint status

GET /management/v1/endpoints/{endpoint_id}

Retrieve endpoint status

Python

import requests

url = "https://api.cerebras.ai/management/v1/endpoints/{endpoint_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "name": "my-org-gpt-oss-120b",
  "model_arch_id": "gpt-oss-120b",
  "deployed_models": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "model": "orgs/my-org/models/gpt-oss-120b/versions/1",
      "version_alias": "production-jan-12-2026-finetuned",
      "created": 1736700000,
      "state": "complete"
    }
  ],
  "managing_org_name": "my-org",
  "created": 1736600000,
  "updated": 1736700000
}

This feature is in Private Preview. For access or more information, contact us or reach out to your account representative.

Describes a stable endpoint and the deployment records currently associated with it. Each deployment record identifies a running model version and its rollout status.

Authorizations

Authorization · string · header · required

Management API key generated from the Management API keys section on the API keys page at https://cloud.cerebras.ai. Use the format: Bearer <MANAGEMENT_API_KEY>

Path Parameters

endpoint_id · string · required

Unique identifier for the endpoint. It is used as the model field when making an inference request.

Example: my-org-gpt-oss-120b

curl --location 'https://api.cerebras.ai/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer ${CEREBRAS_API_KEY}" \
--data '{
  "model": "my-org-gpt-oss-120b",
  "messages": [{"content": "Hello!", "role": "user"}]
}'

Response

200 - application/json

Successful Response

A stable endpoint and the deployment records currently associated with it.

name · string · required

Stable endpoint ID (e.g. my-org-gpt-oss-120b). This field is named name for API compatibility.

model_arch_id · string · required

Name of the model architecture (e.g. llama3.1-8b, gpt-oss-120b).

deployed_models · DeployedModel · object[] · required

Deployment records currently associated with this endpoint. The field name is retained for API compatibility.

Hide child attributes

deployed_models. id · string · required

Deployment ID for this running model version. This is the UUID generated when the deployment is created.

deployed_models. model · string · required

Model version resource name in the format of orgs/<org_name>/models/<model_arch_id>/versions/<version_id>.

deployed_models. created · integer · required

Unix timestamp (in seconds) when the deployment was created.

deployed_models. state · enum<string> · required

Rollout status reported for the deployment.

Available options: not_started, in_progress, rolling_back, rolled_back, done, error, cancelled

deployed_models. version_alias · string | null

Original version reference from deploy request (alias or integer version ID as specified by user).

deployed_models. max_unavailable_replicas · integer | null

Maximum number of replicas that can be unavailable during rollout.

deployed_models. rollout_replicas_updated · integer | null

Number of replicas that have been updated in the rollout.

deployed_models. rollout_total_replicas · integer | null

Total number of replicas in the deployment.

deployed_models. rollout_error_message · string | null

Error message from the rollout, if any.

created · integer · required

Unix timestamp (in seconds) when the endpoint was created.

updated · integer · required

Unix timestamp (in seconds) when the endpoint was last updated.

managing_org_name · string | null

Organization that has management access to this endpoint.