Assistants

Delete an assistant

Changed on

Delete an AI Assistant by assistant_id.

By default this performs a soft delete: the assistant moves to the Recently Deleted list and stays restorable for 30 days, after which it is permanently deleted automatically. The assistant's versions and TeXML application are preserved during the retention window.

Pass hard_delete=true to skip the retention window and permanently delete the assistant immediately. A hard delete erases the assistant and all of its versions, and deletes its TeXML application unless phone numbers are still assigned to it. It does not delete conversations, recordings, shared tools the assistant referenced, or knowledge-base embeddings.

Deletion fails with 400 if other assistants reference this one through a handoff tool or a conversation-flow edge — remove those references first.

delete/ai/assistants/{assistant_id}

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/ai/assistants/{assistant_id}
  • Auth: HTTP bearer

Path parameters

assistant_idstring required

Unique identifier of the assistant.

Query parameters

hard_deleteboolean

Permanently delete the assistant immediately instead of soft-deleting it to the Recently Deleted list, where it stays restorable for 30 days.

Response

Successful Response

idstring required
objectstring required
deletedboolean required

Changes

  • 8186b4f1205dRevision changes
    • info

      added the new optional query request parameter hard_delete

    • info

      added the non-success response with the status