Przejdź do głównej zawartości

Append user input and start an assistant turn

POST 
/api/v2/chat-sessions/:session_id/turns

The request creates one user message and one asynchronous turn. The response is the updated canonical session, not a separate job object. Only one active turn is allowed per session.

Request​

Responses​

User input persisted and assistant generation accepted

Response Headers
    X-Contract-Version

    Version of the gaius-api-contracts release the backend runs (legalgpt-contracts), sent on every response. Clients compare it with the @legalgpt/contracts version they were built with; both packages share one version per contract.

    Cache-Control

    Prevents storage of sensitive authenticated chat data.

    ETag

    Strong session revision tag. Polish has no suffix; other supported languages append the language code. Use the same Accept-Language on reads and conditional mutations.

    Link

    RFC 8288 link to the accepted turn's SSE stream.

    Content-Language

    Language selected for outgoing generic tool-status labels and known HTTP/timeline error text. HTTP reason-phrase titles remain language-neutral.