---
title: "Upload model version"
method: POST
path: "/management/v1/orgs/{org_name}/models:upload"
---

# Upload model version

`POST /management/v1/orgs/{org_name}/models:upload`

## 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`.

## Request body

- ModelVersionUploadRequest
  - `model_arch_id` string, required — Name of the model architecture (e.g. `llama3.1-8b`, `gpt-oss-120b`).
  - `model` ModelVersionUploadRequestModel, required
    - `version_aliases` string[], nullable — Optional list of aliases that can be used to refer to this new version instead of the autogenerated integer number. Must match pattern: `^[a-z][a-zA-Z0-9-]{0,126}[a-z0-9]$`.
    - `weight_uri` string — S3 URI to customer-provided weights. Must match pattern: `^s3://[a-zA-Z0-9.\-_/~]+$`.
    - `system_fingerprint_suffix` string, nullable — Optional custom suffix appended after the auto-generated fingerprint pattern. The final fingerprint will be `fp_{backend_hash}_{model_arch_id}_v{version_id}_{custom_suffix}` if provided, or just `fp_{backend_hash}_{model_arch_id}_v{version_id}` if not. Must match pattern: `^[a-zA-Z0-9-]{1,64}$`. This suffix appears in the `system_fingerprint` field of inference responses, allowing you to identify which model version served a request. Example response:

## Response `200`

Successful Response

- ModelVersionUploadResponse
  - `name` string, required — Model version name in the format of `orgs/<org_name>/models/<model_arch_id>/versions/<version_id>`. `<version_id>` is an auto-incrementing integer assigned by the system upon successful upload. This full model version name can be used for model deployment.
  - `done` boolean, required — Whether the operation is complete.
  - `response` unknown

---

[API](https://skmtc.dev/cerebras/apis/cerebras-inference-api.md) · [All operations](https://skmtc.dev/cerebras/apis/cerebras-inference-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cerebras/apis/cerebras-inference-api/revisions/c8b3fb650198?raw)