---
title: "Task Aliases"
method: GET
path: "/models/task-aliases"
tags: ["models"]
---

# Task Aliases

`GET /models/task-aliases`

## 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/task-aliases`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Every task alias of the workspace, by task and alias, each as GET /models?alias=&task=
resolves it.

## Query parameters

- `workspace` string, uuid, nullable

## Response `200`

Successful Response

- union[]
  - 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)