---
title: "Versions"
method: GET
path: "/models/versions"
tags: ["models"]
---

# Versions

`GET /models/versions`

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

The workspace's model and adapter versions, newest first, each as GET /models/{id}
answers it: every one, or a page of `limit`, a full one setting X-Next-After (its last
version's id), which `after` takes. X-Total-Count is how many match. Filters: `ref`
(repeatable) the versions it names, by their id or the job that registered them; `kind`
those of one kind.

## Query parameters

- `workspace` string, uuid, nullable
- `ref` string[], nullable
- `kind` 'policy' | 'lora_adapter' | 'full_model', nullable
- `limit` integer, nullable
- `after` string, uuid, nullable

## Response `200`

Successful Response

- union[]
  - union
    - ModelVersion
      - `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
    - AdapterVersion
      - `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

## 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)