POST
/v1/conversationsConversations
Stateful, server-managed message history with locking and 5,000-message caps.
Request
- HTTP
- POST
- URL
- /v1/conversations
- Auth
- api_key
Try it
# create
curl https://api.fightclub.pro/v1/conversations \
-H "Authorization: Bearer $FC_API_KEY" \
-d '{"customer":"cust_42","metadata":{"thread":"support-12"}}'Parameters
| Name | Type | Description |
|---|---|---|
| customer | string | FC Customer ID owning this conversation. |
| metadata | object | Free-form metadata. |
Response fields
| Name | Type | Description |
|---|---|---|
| id | string | Conversation ID (conv_*). |
| created_at | integer | Unix timestamp. |
| message_count | integer | Current message count. |
Errors
- 401
invalid_api_key, Missing or revoked key. - 409
conversation_locked, Another writer holds the lock; retry after.
See the full error reference.