Skip to main content
DELETE
Delete character
Remove one of your characters by the id from GET /v1/characters. 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 characters can be deleted here; any other id is a 404 character_not_found. Requests that already ran with the character 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

character_id
string<uuid>
required

The character's id.

Response

The character was deleted.

Last modified on September 18, 2026