curl --silent --show-error --fail-with-body --request DELETE \
--url 'https://api.example.com/api/response/threads/{id}' \
--header 'x-widget-token: YOUR_API_KEY' \
--header 'x-widget-thread-token: REPLACE_WITH_X_WIDGET_THREAD_TOKEN'
{
"ok": true
}
Alias of DELETE /api/threads/{id}
For an existing protected thread, send its x-widget-thread-token capability in addition to widget identity…
DELETE
/
api
/
response
/
threads
/
{id}
curl --silent --show-error --fail-with-body --request DELETE \
--url 'https://api.example.com/api/response/threads/{id}' \
--header 'x-widget-token: YOUR_API_KEY' \
--header 'x-widget-thread-token: REPLACE_WITH_X_WIDGET_THREAD_TOKEN'
{
"ok": true
}
For an existing protected thread, send its
x-widget-thread-token capability in addition to widget identity. Widget identity is verified when signing is configured; tokenless compatibility does not establish tenant ownership. See the authentication and recovery guide for credential and retry rules.
Path parameters
Headers
Capability required for an existing thread that has an issued token. Legacy capability-less threads are denied when STATESET_THREAD_TOKEN_REQUIRED=true.
Response
object
Status codes
| Code | Meaning |
|---|---|
200 | Deletion outcome (ok: false when the id was unknown) |
401 | Widget token missing, malformed, expired, from the future, or badly signed |
403 | Thread capability missing/wrong, thread owner mismatch, or token identity mismatch |
429 | Too many requests for this IP (scoped by verified org/agent) |
500 | Unhandled error |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request DELETE \
--url 'https://api.example.com/api/response/threads/{id}' \
--header 'x-widget-token: YOUR_API_KEY' \
--header 'x-widget-thread-token: REPLACE_WITH_X_WIDGET_THREAD_TOKEN'
{
"ok": true
}
Last modified on November 13, 2026