Deletes a conversation and its messages. Credit ledger rows and anything Conductor created (dashboards, test cases) are kept.
Request#
| Field | Type | Required | Description |
|---|---|---|---|
id |
string | Yes | Conversation ID, for example conductor_1d3f5a7c9e2b4d6f8a0c2e4b. |
Example request#
curl -X DELETE https://api.tried.com.au/conductor/sessions/conductor_1d3f5a7c9e2b4d6f8a0c2e4b \
-H "Authorization: Bearer $TRIED_API_KEY"const res = await fetch("https://api.tried.com.au/conductor/sessions/conductor_1d3f5a7c9e2b4d6f8a0c2e4b", {
method: "DELETE",
headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
// res.status is 204import os, requests
res = requests.delete(
"https://api.tried.com.au/conductor/sessions/conductor_1d3f5a7c9e2b4d6f8a0c2e4b",
headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
# res.status_code is 204Response#
204 No Content
The response has no body.
Errors#
| Status | When |
|---|---|
401 |
Missing or invalid API key. |
403 |
The key's IP allowlist or scopes reject the request. This route needs the admin scope. Dashboard users with the member role get The member role is read-only. |
404 |
No conversation with that ID in the workspace: Conversation not found. |
429 |
Rate limit exceeded. See Rate limits. |
See Errors for the body format.
Retell compatibility#
Retell's public API reference has no Conductor endpoints, so this route has no Retell SDK equivalent.