---
title: "Start Conversation"
method: POST
path: "/conversations/start"
tags: ["conversations"]
---

# Start Conversation

`POST /conversations/start`

## Request

- Base URL: `https://api.threadchain.pro` (the document declares no server; this is the origin it was published from)
- URL: `https://api.threadchain.pro/conversations/start`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

Start a new conversation and linked questionnaire session.

## Request body

- ConversationCreateRequest
  - `title` string, nullable
  - `product_type` 'jewelry' | 'clothes', required

## Response `201`

Successful Response

- ConversationResponse
  - `conversation_id` string, uuid, required
  - `session_id` string, uuid, required
  - `product_type` 'jewelry' | 'clothes', required
  - `question` QuestionTemplateSchema, required
    - `product_type` 'jewelry' | 'clothes', required
    - `phase` string, required
    - `question_text` string, required
    - `input_type` 'text' | 'yes_no' | 'multiple_choice' | 'file_upload' | 'number' | 'textarea' | 'checkbox', required
    - `options` union[], nullable
      - union
        - string
        - QuestionOption
          - `label` string, required
          - `image_url` string, nullable
          - `description` string, nullable
    - `validation_rules` object, nullable
    - `order` integer, required
    - `depends_on_question_id` string, uuid, nullable
    - `depends_on_answer` string, nullable
    - `placeholder` string, nullable
    - `help_text` string, nullable
    - `help_display` 'link' | 'inline'
    - `id` string, uuid, required
    - `created_at` string, date-time, required
  - `progress` object, required: Progress info with current and total questions

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/threadchain/apis/threadchain-backend.md) - [All operations](https://skmtc.dev/threadchain/apis/threadchain-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/threadchain/apis/threadchain-backend/revisions/8ee288a7e6bd?raw)