aiThreadsClearMessages
AiSuccessResponse aiThreadsClearMessages(AiThreadsClearMessagesRequest)
DELETE /api/2.0/ai/threads/clear-messages
Clear messages
Removes every message of a thread while keeping the thread, its title and its model binding, and bumps its last-edit date. The messages are gone for good. Unlike delete this does not verify that the thread exists, so clearing an unknown threadId reports success rather than 404. The answer only confirms the write.
Parameters
| Name | In | Type | Description | Notes |
|---|---|---|---|---|
| AiThreadsClearMessagesRequest | body | String | The ID of the thread to empty, as a bare JSON string. | [required] |
Responses
| Status code | Description | Type | Response headers |
|---|---|---|---|
| 200 | Confirms the request was accepted. It does not mean the thread existed. | AiSuccessResponse | - |
| 400 | threadId is missing. | AiErrorResponse | - |
| 401 | Missing asc_auth_key cookie or Authorization header. | AiErrorResponse | - |
| 403 | AI is disabled for this portal, the caller is a guest, or the room named by entityId is one the caller cannot open. Relayed from the DocSpace AI service or the Files API. | AiErrorResponse | - |
| 413 | The request body is larger than 100 KB, the JSON parser's limit on this route. | AiErrorResponse | - |
| 500 | Unhandled failure. The reason is logged server-side and never echoed back. | AiErrorResponse | - |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json