API DocsAPI Docs / Ai / Threads / Messages / Delete

DELETE /api/v1/ai/threads/{thread-id}/messages/{message-id}

Deletes a specific message from an AI thread. Any message after the specified message will also be deleted, as messages are chained.

Permissions

URL Parameters

Request Example

DELETE /api/v1/ai/threads/123/messages/456
Authorization: Bearer {token}

Response

204 No Content

Despite the 204, this endpoint does return a JSON body — a localized confirmation message. HTTP defines 204 as bodyless, so some clients and proxies discard it; treat the body as informational, not something to depend on.

{
  "message": "AI message deleted successfully."
}

Localized from messages.ai.threads.messages.deleted_successfully (fa: “پیام AI با موفقیت حذف شد.”).

Error Responses