Skip to main content
DELETE
Delete reference
Remove one of your references by the id from GET /v1/references. The response is 204 with no body. From then on a prompt that mentions its handle is refused with 400 invalid_config, and the handle may be taken by a new character or reference. Only your own references can be deleted here; any other id is a 404 reference_not_found. Requests that already ran with the reference keep their results.

Authorizations

Authorization
string
header
required

An API key from Settings → API, sent as Authorization: Bearer mage_sk_…. Keys are for server-side code only.

Path Parameters

reference_id
string<uuid>
required

The reference's id.

Response

The reference was deleted.

Last modified on September 18, 2026