Delete a conversation

.md

Throw a conversation away for good, with its messages and files.

Scopesai:write
DELETE/v1/me/ai/conversations/{id}

The conversation, every message in it and every file attached to a question are deleted at once. There is no bin and no undo, on the website either, where the conversation disappears as well.

Stop an answer that is still being written before deleting its conversation. A worker that is already writing it does not notice the deletion, finishes the answer nobody can read any more, and what it used is booked all the same.

Request

curl -X DELETE https://api.proppertrading.com/v1/me/ai/conversations/01a16153-9dbe-71df-b040-c1a4967ffbe1 \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f"

Response

204, with no body.

Errors

StatusCodeMeaning
400workspace_requiredOur own staff, without a firm in Propper-Workspace
403ai_unavailableThe firm has the assistant switched off for this chat
403forbiddenStaff whose role does not include use_ai_chat
403insufficient_scopeThis device does not hold ai:write
404resource_not_foundNo conversation of yours with that id in this chat and this firm
429rate_limit_exceededTwenty questions and deletions a minute, shared with the website