Skip to main content
POST
/
conversations
Create conversation
curl --request POST \
  --url https://api.qwix.chat/api/v1/conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "modelId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "encryptionPassword": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "model": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "encryptionEnabled": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.qwix.chat/llms.txt

Use this file to discover all available pages before exploring further.

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).