Atmee.aiDocs
APIAPI referenceAvatars

Delete (soft) an avatar

DELETE
/v1/avatars/{avatarId}

Soft-deletes the avatar: it disappears from the API at once and its unfinished captures are cancelled. After the retention period every file of the avatar -- every version's portrait, voice sample and takes included -- is removed permanently.

Authorization

headerX-Api-Key<token>

Secret embed API key (sk_atmee_...; keys minted before 2026-09 carry sk_live_...), held by the customer's own backend and never sent to a browser. Format: X-Api-Key: sk_atmee_....

Path Parameters

avatarId*string
Formatuuid

Response Body

Deleted.

Example Request
curl -X DELETE 'https://api.atmanity.us/v1/avatars/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
Empty

Update name, description, visibility, language or preview message PATCH

Persona edits (whoPrompt, whatPrompt, greeting, self-introduction, guardrails, habits, aliases, name) rebuild the persona in the background.

The avatar's portrait GET

Next Page

Delete (soft) an avatar — Atmee Docs