---
title: "Remove a successor model replacement"
method: DELETE
path: "/routing/successor/replacements"
tags: ["Gateway"]
---

# Remove a successor model replacement

`DELETE /routing/successor/replacements`

## Request

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

Removes the workspace's choice for a model, so the catalogue's successor applies again. Owners and admins; settings:write required.

## Query parameters

- `model` string, required: Model identifier. This is a runtime string so newly released models can be used without waiting for an SDK update.

## Response `200`

Replacement removed

- SuccessorReplacementRemovedResponse
  - `deleted` boolean
  - `model` string

## Other responses

- `400`: Missing or invalid model
- `401`: Unauthorized
- `404`: No replacement is saved for this model

## Changes

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

[Operation history](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/changes/routing/successor/replacements/delete.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)