---
title: "Alias History"
method: GET
path: "/models/aliases/{alias}/history"
tags: ["models"]
---

# Alias History

`GET /models/aliases/{alias}/history`

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

## Path parameters

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

## Query parameters

- `workspace` string, uuid, nullable
- `task` string, nullable
- `replay` boolean

## Response `200`

Successful Response

- History
  - `events` Event[], required
    - `at` string, date-time, required
    - `kind` 'decision' | 'canary' | 'guard_look' | 'stable_run' | 'rollback' | 'click' | 'alias_move' | 'override' | 'superseded' | 'reinstated', required
    - `workspace_id` string, uuid, required
    - `actor` string, nullable, required
    - `release_decision_id` string, uuid, nullable
    - `route_id` string, uuid, nullable
    - `evidence` object, required
    - `detail` object, required
    - `replay` Replayed
      - `stored` object, required
      - `replayed` object, required
      - `match` boolean, required
  - `replayed` integer, nullable
  - `mismatches` integer, nullable

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