---
title: "List Key Routes"
method: GET
path: "/llm/keys"
tags: ["llm"]
---

# List Key Routes

`GET /llm/keys`

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

The routing of the live traffic keys of a workspace (the caller's, else every
workspace's): each one's pin, and whether the task routes serve it, which needs trace
policy full and no pin: an OS3-models key (``os3_models``) only by the routes that send
nothing to the organisation's own vendors. An organisation-wide key is never routed, so it
is not listed. With ``traffic``, each key's share of each live canary and release, from its
latest requests (0 for an OS3-models key on a route to the organisation's own vendor); else
``tasks`` is null.

## Query parameters

- `workspace_id` string, uuid, nullable
- `traffic` boolean

## Response `200`

Successful Response

- KeyRoute[]
  - `id` string, uuid, required
  - `name` string, required
  - `prefix` string, required
  - `workspace_id` string, uuid, required
  - `trace_policy` string, required
  - `route_pin` 'incumbent', nullable, required
  - `os3_models` boolean, required
  - `routed` boolean, required
  - `tasks` KeyTaskRoute[], nullable, required
    - `task_id` string, uuid, required
    - `task_label` string, required
    - `decision_id` string, uuid, required
    - `state` string, required
    - `configured_percent` integer, required
    - `eligible_percent` integer, required
    - `without_headers_percent` integer, required
    - `available` boolean, required
    - `requests` integer, required
    - `candidate_requests` integer, required
    - `subjects` integer, required
    - `without_headers` integer, 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)