Delete chat
DELETE
https://app.sulus.ai/api/v1/agents/{agent_id}/chats/{chat_id}
Delete a chat and its messages
Authentication
Send a bearer token created on your dashboard's Developer page:
Authorization: Bearer <YOUR_API_KEY>
Path parameters
agent_id
string
Required
The agent id (UUID).
Validation:
uuid (route-constrained)Stored in
ai_projects.uidchat_id
string
Required
The chat id (UUID).
Validation:
uuid (route-constrained)Stored in
ai_chats.uidErrors
| Status | Meaning | Body |
|---|---|---|
404 |
Agent not found, or you do not have access to it | |
404 |
Chat not found in this agent, or it was created by a different token | |
401 |
Missing or invalid bearer token | |
403 |
Feature ai_chat not enabled for the account |
curl --request DELETE \
--url https://app.sulus.ai/api/v1/agents/{agent_id}/chats/{chat_id} \
--header 'Authorization: Bearer <YOUR_API_KEY>'
import requests
url = "https://app.sulus.ai/api/v1/agents/{agent_id}/chats/{chat_id}"
headers = {"Authorization": "Bearer <YOUR_API_KEY>"}
response = requests.delete(url, headers=headers)
print(response.json())
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://app.sulus.ai/api/v1/agents/{agent_id}/chats/{chat_id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
Response
200
{
"object": "chat.deleted",
"id": "b2c3d4e5-0000-4000-8000-000000000002",
"deleted": true
}
Response — DELETE
/agents/{agent_id}/chats/{chat_id}
200
{
"object": "chat.deleted",
"id": "b2c3d4e5-0000-4000-8000-000000000002",
"deleted": true
}