AI Chat

Get-or-create the current user's private chat for a context.

post/projects/{project_id}/ai/conversations

Request

Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
URL: /api/projects/{project_id}/ai/conversations
Auth: HTTP bearer

project_idinteger required

ai_modelstring nullable

ai_permission_modestring nullable

ai_providerstring nullable

Provider pinned to this conversation. Omitted requests use the current instance preference.

ai_thinking_levelstring nullable

context_idstring required

The entity id (ints stringified).

context_typestring required

e.g. "deployment".

active_turn_idstring nullable

ai_modelstring required

ai_permission_modestring required

ai_providerstring required

ai_thinking_levelstring nullable

application_idinteger nullable

context_idstring required

context_typestring required

created_atstring required

last_activity_atstring required

project_idinteger nullable

public_idstring required

statusstring required

titlestring nullable

turn_started_atstring nullable

turn_statusstring required

Server-authoritative lifecycle for the current/most recent turn.

No recorded changes to this operation across all 50 revisions of this API.