Delete a project thread

DELETE 
/ai/projects/:project_id/threads/:thread_id

Permanently deletes a thread, every message in it and every file attached to it, and drops it from the project's RecentThreads list. You need at least read-only access to the project. There is no undo and no soft delete. The call is idempotent only in the sense that a second attempt fails with a not-found error rather than deleting anything else.

Request

Responses

200

The thread, its messages and its files were deleted. The deletion has already completed when this returns.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security

400

The request was invalid or you do not have permission. The body is {"Message": " - "}. Common cases include an unknown project or thread (IPV-1002), no access to the project (AUTH-1012), a missing role_id header (AUTH-1001), or the role lacking ai.manage (AUTH-1030). Permission failures return 400, not 403.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security

500

An unexpected server error. The body is {"Message": "GE-1008 - Could not complete the request. Please try again."}. A failure while removing the thread's files or record surfaces as DB-1003, and the thread may be partly deleted.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security