Archive Assistant

Method: DELETE

Endpoint: https://api.assistable.ai/v2/delete-assistant

Think of this as the "Delete" button. If an assistant is old, no longer needed, or was created by mistake, use this endpoint to remove it from your account.

1. Authorizations

You need permission to delete things.

• Header Name: Authorization

• Value: Bearer <your_token_here>

2. Query Parameters (The Target)

Unlike the "Create" step where you send a lot of data, here you only need to send one thing: the ID of the assistant you want to remove. This is sent as a Query Parameter (attached to the end of the link).

3. Example Request (Code)

Copy the code below. Notice how the assistant_id is added to the end of the URL.

Bash

curl --request DELETE \
  --url 'https://api.assistable.ai/v2/delete-assistant?assistant_id=asst_12345' \
  --header 'Authorization: Bearer <token>'

4. Success Response

If the deletion works, the system will confirm it with a 200 OK status.

JSON

{
  "status": 200,
  "data": {
    "status": "deleted",
    "id": "asst_12345"
  }
}

5. Troubleshooting

• Status 404: The assistant_id you tried to delete doesn't exist (maybe it was already deleted?).

• Status 401: Your API key is invalid.

• Status 400: You forgot to include the assistant_id.