Create a thread in a project

POST 
/ai/projects/:project_id/threads

Starts a new conversation thread in a project and returns its identifier. You need at least read-only access to the project. The call takes no request body. The thread is created with the title "New Thread" and visibility private, and you become its owner; rename it or share it afterwards with the thread update endpoint. It also joins the project's RecentThreads list, which keeps the five most recently active threads.

Request

Responses

200

The thread was created. ThreadId is the identifier to use on the thread detail, update, delete and messages endpoints.

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 (IPV-1002), no access to the project (AUTH-1012), a missing role_id header (AUTH-1001), or the role lacking ai.view (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."}.

Response Headers

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