# Create Conversation

> Create a new conversation.

Canonical URL: https://docs.botyard.io/docs/api/conversations/create_conversation_v1_orgs__org_id__conversations_post

`POST /v1/orgs/{org_id}/conversations`

Create a new conversation.

Scope is derived from the auth context when not provided:
- JWT users default to ``user`` scope (conversation owned by the caller).
- API keys default to ``org`` scope (org-wide conversation).

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `org_id` | path | yes | string |  |

## Request body

`application/json`: ConversationCreate (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bot_id` | string \| null | no | Bot UUID (provide this or bot_slug, not both) |
| `bot_slug` | string \| null | no | Bot slug — resolved to UUID server-side |
| `conversation_scope` | ConversationScope \| null | no | Access scope (derived from auth context when omitted) |
| `title` | string \| null | no | Optional title |
| `metadata` | object \| null | no | Key/value metadata (max 16 keys, lowercase keys, scalar values only) |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| `201` | Successful Response | ConversationResponse |
| `default` | RFC 9457 Problem Details error response | ProblemDetails |

Full schemas: operation `create_conversation_v1_orgs__org_id__conversations_post` in the OpenAPI spec at https://api.botyard.io/openapi.json.