# Create Chat

**POST /api/v1/chats**

Creates a new chat session for the organization. Can be called via Dashboard (JWT) or Public API (API Key).


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth & Bearer auth


## Parameters

### Path parameters
- **slug** (string)
  Organization Slug (Required for Public API)


### Body: application/json (object)
Chat Details
- **metadata** (object)
  Use the structured type
- **tags** (array[string])

- **title** (string)

- **user_id** (integer)
  Optional, for anonymous chats


## Responses
### 201
message: Chat created successfully, chat_id: uint64

#### Body: application/json (object)
object
### 400
Invalid request data

#### Body: application/json (object)
- ***** (string)


### 401
Unauthorized (JWT or API Key invalid/missing, or Org ID not found)

#### Body: application/json (object)
- ***** (string)


### 403
Forbidden (API Key doesn't match slug)

#### Body: application/json (object)
- ***** (string)


### 500
Failed to create chat or process tags/metadata

#### Body: application/json (object)
- ***** (string)



[Powered by Bump.sh](https://bump.sh)