Skip to main content
PATCH
/
management
/
v1
/
orgs
/
{org_name}
/
models
/
{model_arch_id}
/
versions
/
{version_id}
Update model version aliases
curl --request PATCH \
  --url https://api.cerebras.ai/management/v1/orgs/{org_name}/models/{model_arch_id}/versions/{version_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "version_aliases": [
    "production",
    "v1-stable",
    "latest"
  ]
}
'
{
  "name": "orgs/my-org/models/gpt-oss-120b/versions/1",
  "version_aliases": [
    "production",
    "v1-stable",
    "latest"
  ]
}
This feature is in Private Preview. For access or more information, contact us or reach out to your account representative.
Assign unique aliases to model versions instead of using autogenerated IDs. Use these aliases anywhere you would normally use an integer version ID.

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

​
org_name
string
required

Cerebras customer management organization name found under Management API keys on the API keys page at https://cloud.cerebras.ai.

Note: This is not to be confused with org_id.

​
model_arch_id
string
required

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

​
version_id
string
required

Autoincrementing integer or user-defined alias to identify model version.

Body

application/json
​
version_aliases
string[]
required

List of aliases for the model version. Must match pattern: ^[a-z][a-zA-Z0-9-]{0,126}[a-z0-9]$.

Aliases must be unique within an organization and model architecture. If an alias is already assigned to another version, it must first be removed from that version before it can be reassigned.

Pattern: ^[a-z][a-zA-Z0-9-]{0,126}[a-z0-9]$

Response

200 - application/json

Successful Response

​
name
string
required
​
version_aliases
string[]
required