Update Assistant

Method: PUT Endpoint: https://api.assistable.ai/v2/update-assistant

Think of this as the "Edit" button. If you made a typo in your assistant's name, want to switch from GPT-4 to a faster model, or need to update its instructions, you use this endpoint.

1. Authorizations

Just like the other endpoints, you need your "key" to make changes.

Header Name: Authorization
Value: Bearer <your_token_here>

2. Body Parameters (The Settings)

This is the data you send to the system to tell it who to update and what to change.

Field	Type	Required?	Description
`assistant_id`	string	Yes	The ID of the assistant you want to edit (e.g., `12745xx800`).
`name`	string	No	The new name for the assistant.
`description`	string	No	The new description.
`prompt`	string	No	New instructions (e.g., "Be more polite").
`model`	string	No	Switch the AI brain (e.g., `gpt-4` or `claude-3`).
`location_id`	string	No	Move the assistant to a different location ID.
`voice_id`	string	No	Change the voice ID.

Export to Sheets

Note for Non-Techies: You do not need to fill out every field. Only include the assistant_id (so we know who to fix) and the specific fields you want to change. If you leave name out, the old name stays the same.

3. Example Request (Code)

In this example, we are only updating the assistant's name and changing its model to GPT-4.

Bash

curl --request PUT \
  --url https://api.assistable.ai/v2/update-assistant \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "assistant_id": "asst_12345",
  "name": "Updated Support Bot",
  "model": "gpt-4"
}'

4. Success Response

If the update works, the system will reply with a 200 OK message and show the updated details.

JSON

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

5. Common Errors (Troubleshooting)

"Missing assistant_id": The system doesn't know which assistant to update. Make sure you included the ID in your data.
Status 404: The assistant_id you provided doesn't exist.
Status 401: Your API key is wrong or missing.