---
title: "Get the Auto Router"
method: GET
path: "/v1/org/auto-router"
tags: ["Inference Providers"]
---

# Get the Auto Router

`GET /v1/org/auto-router`

## Request

- Base URL: `https://api.openworklabs.com`
- URL: `https://api.openworklabs.com/v1/org/auto-router`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns whether the organization's Auto Router is enabled, whether the AI Gateway can route (routing: ready, missing_key when it has no TypeSafe key, or unknown when it could not be reached), and its routes in order: each AI Gateway model, when to use it, and the one thinking level it runs at. The first route is the default model, used when no other route matches, with a fixed prompt. Requires the View Gateway providers permission and the Auto Router feature.

## Response `200`

Auto Router returned.

- AutoRouterSettings
  - `enabled` boolean, required
  - `routing` 'ready' | 'missing_key' | 'unknown', required
  - `routes` AutoRouterRoute[], required
    - `id` string, required
    - `providerId` string, required
    - `modelId` string, required
    - `prompt` string, required
    - `thinkingLevel` 'default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max', required
    - `isDefault` boolean, required
  - `canEdit` boolean, required

## Other responses

- `401`: Authentication required.
- `403`: The caller lacks the View Gateway providers permission.
- `404`: The organization was not found, or the Auto Router feature is off.

## Changes

- **2026-10-27** `9fa47a73a88e`: 1 breaking, 2 info
  - removed the required property `routes/items/thinkingLevels` from the response with the `200` status
  - added the required property `routes/items/isDefault` to the response with the `200` status
  - added the required property `routes/items/thinkingLevel` to the response with the `200` status
- **2026-10-27** `cc371ee3c4ff`: 1 info
  - added the required property `routing` to the response with the `200` status
- **2026-10-27** `7e95da81abe4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/org/auto-router/get.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) - [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openworklabs/apis/den-api/revisions/8117bc7c5626?raw)