---
title: "List successor model replacements"
method: GET
path: "/routing/successor/replacements"
tags: ["Gateway"]
---

# List successor model replacements

`GET /routing/successor/replacements`

## Request

- Base URL: `https://api.phaseo.app/v1`
- URL: `https://api.phaseo.app/v1/routing/successor/replacements`
- Auth: HTTP bearer

Lists the workspace's own choices of replacement for models no provider serves any more. Successor routing's switch and price policy are in /settings. Any workspace member; settings:read required.

## Response `200`

Replacements

- SuccessorReplacementListResponse
  - `data` SuccessorReplacementRow[], required
    - `model` string
    - `successor` string, nullable
    - `updated_at` string, date-time, nullable

## Other responses

- `401`: Unauthorized

## Changes

- **2026-10-28** `72ba9c856a2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/changes/routing/successor/replacements/get.md)

---

[API](https://skmtc.dev/phaseo/apis/phaseo-gateway-api.md) - [All operations](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/revisions/5ca9bb220d25?raw)