Skip to main content
POST
Reset a chat's conversation state
Clears messages for a new conversation on the same thread. Attachments stay. Not billed.

Authorizations

Authorization
string
header
required

Organisation API key from Settings → API / /api/keys/. The secret is shown once. Send Authorization: Bearer sk-abacus-…. One active key per organisation. Ingest (/api/v2/ingest/*) refuses API keys — that surface is Auth0-only with ingest:read / ingest:write scopes.

Path Parameters

thread_id
string
required

Response

200 response for POST /api/v2/chats/<thread_id>/reset/.

Fields: thread_id: The reset chat's thread id (echo). messages_deleted: Number of ChatMessage rows removed.

thread_id
string
required

The reset chat's thread id.

messages_deleted
integer
required

Number of ChatMessage rows removed.

Required range: x >= 0