---
title: "Flip Alias"
method: PUT
path: "/models/aliases/{alias}"
tags: ["models"]
---

# Flip Alias

`PUT /models/aliases/{alias}`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/models/aliases/{alias}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `alias` 'champion' | 'candidate', required

## Request body

- AliasIn
  - `workspace_id` string, uuid, required
  - `model_version_id` string, uuid, nullable
  - `adapter_version_id` string, uuid, nullable
  - `task` string, nullable
  - `release_decision_id` string, uuid, nullable
  - `override_reason` string, nullable
  - `rollout` 'now' | 'rings'

## Response `200`

Successful Response

- union
  - ResolvedModel
    - `kind` 'policy'
    - `id` string, uuid, required
    - `tenant_id` string, uuid, required
    - `workspace_id` string, uuid, required
    - `job_id` string, uuid, nullable, required
    - `checkpoint_sha256` string, required
    - `checkpoint_ref` string, required
    - `dataset_manifest_sha256` string, required
    - `base` string, required
    - `base_revision` string, required
    - `recipe_sha256` string, nullable, required
    - `image_digest` string, required
    - `min_controller` string, required
    - `receipt_ref` string, required
    - `receipt_sha256` string, required
    - `receipt_verified` boolean, required
    - `use_rabc` boolean, required
    - `required_task_suffix` string, required
    - `config_sha256` string, nullable, required
    - `dev_strata` object, nullable
    - `calibration_sha256` string, nullable
    - `holdout_flags` object, nullable
    - `serving_refusal` string, nullable
    - `created_at` string, date-time, required
    - `alias` 'champion' | 'candidate', required
    - `model_version_id` string, uuid, required
    - `alias_updated_at` string, date-time, required
    - `task` string, nullable
    - `rollout_from` string[]
    - `rollout_targets` RolloutTarget[]
      - `id` string, uuid, required
      - `name` string, required
      - `model_version_id` string, uuid, required
      - `refused` string, nullable
    - `rollout_rings` RolloutRing[]
      - `id` string, uuid, required
      - `model_version_id` string, uuid, required
      - `stage` string, required
  - ResolvedAdapter
    - `kind` 'lora_adapter' | 'full_model'
    - `id` string, uuid, required
    - `tenant_id` string, uuid, required
    - `workspace_id` string, uuid, required
    - `job_id` string, uuid, nullable, required
    - `receipt_schema` string, required
    - `base` string, required
    - `base_repo` string, required
    - `base_revision` string, required
    - `digest` string, required
    - `adapter_sha256` string, required
    - `adapter_config_sha256` string, nullable, required
    - `config_sha256` string, required
    - `adapter_ref` string, required
    - `dataset_manifest_sha256` string, required
    - `image_digest` string, required
    - `receipt_ref` string, required
    - `receipt_sha256` string, required
    - `receipt_verified` boolean, required
    - `parent_id` string, uuid, nullable
    - `created_at` string, date-time, required
    - `alias` 'champion' | 'candidate', required
    - `adapter_version_id` string, uuid, required
    - `alias_updated_at` string, date-time, required
    - `task` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/os3robotics/apis/os3-api.md) - [All operations](https://skmtc.dev/os3robotics/apis/os3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/os3robotics/apis/os3-api/revisions/af32cd4f14bb?raw)