Conversations
Create a conversation
Creates a conversation bound either to a deployed app (`app_id`) or to a hosted conversation model (`model_id`). Exactly one of the two is required.
AuthorizationBearer <token>
Organization or project Access Key created in the Dynamiq console. Used for deployed-app (Runs API), AI Gateway, traces collector, and management API requests. Send as Authorization: Bearer <access-key>.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Body for POST /v1/conversations. Exactly one of app_id or model_id is required.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/conversations" \ -H "Content-Type: application/json" \ -d '{ "title": "Ticket #4812 — duplicate charge", "app_id": "4f6e1c2a-7b8d-4e9f-a1b2-c3d4e5f60718", "org_id": "7c8d9e0f-1a2b-4c3d-8e4f-5a6b7c8d9e0f" }'{
"data": {
"id": "2f3a4b5c-6d7e-4f80-91a2-b3c4d5e6f708",
"title": "Ticket #4812 — duplicate charge",
"app_id": "4f6e1c2a-7b8d-4e9f-a1b2-c3d4e5f60718",
"org_id": "7c8d9e0f-1a2b-4c3d-8e4f-5a6b7c8d9e0f",
"created_at": "2026-06-10T09:10:00Z",
"updated_at": "2026-06-10T09:10:00Z"
}
}{
"error": {
"code": "bad_request",
"message": "Bad Request",
"details": {
"input": "cannot be blank"
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized"
}
}