DELETE/v1/conversations/:id

Auth: tenant — Status: stable

Permanently delete a conversation and all its messages, artifacts, and memory-entry artifact links:

• Messages cascade-delete via FK.
• Artifacts cascade-delete via FK.
• Memory entries that referenced any of those artifacts have their artifact_id nullified by trigger (the entry survives; the link is cleared).

Request

curl -X DELETE \
  -H "Authorization: Bearer atr_…" \
  http://arbiter.example.com/v1/conversations/1

Response

200 OK

{ "deleted": true }

Failure modes

See also

• PATCH/v1/conversations/:id — set archived: true to hide without deleting.
• Artifacts — for the cascade behaviour.
• Structured memory — for the artifact_id clearing trigger.