---
title: "Pin Route"
method: PUT
path: "/llm/keys/{key_id}/route"
tags: ["llm"]
---

# Pin Route

`PUT /llm/keys/{key_id}/route`

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

Pins a gateway key's routing: ``incumbent`` keeps every request of the key on the
incumbent model, null lets the key follow the task routes again. It applies within a
minute. Owners and admins, or their key holding ``admin``; a workspace key pins only its
workspace's keys. Audited.

## Path parameters

- `key_id` string, uuid, required

## Request body

- RoutePin
  - `pin` 'incumbent', nullable, required

## Response `200`

Successful Response

- object

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