Skip to main content
POST
Create conversation

Authorizations

Authorization
string
header
required

JWT from POST /auth/login, or an API key via the same header depending on client configuration.

Body

application/json
modelId
string<uuid>
required
encryptionPassword
string

If set, enables AES-256-GCM encryption for all messages in this conversation. The password is not stored; only ciphertext is persisted. Use the same password with encryptionPassword (POST message) and header X-Conversation-Encryption-Password (GET messages).

Minimum string length: 8

Response

Conversation created

id
string<uuid>
required
model
object
required

Model embedded in conversation list (id and name only)

createdAt
string<date-time>
required
encryptionEnabled
boolean
required

True if the conversation was created with encryptionPassword (message bodies are encrypted at rest).