Skip to content

Create a conversation

Creates a conversation with context. This initializes a new conversation that can be used for subsequent messages.

POST https://app.inconvo.ai/api/v1/conversations


context object Required

A JSON object of arbitrary key-value pairs that describe the caller’s tenancy or permission context. In the backend context filters map these keys to table columns to restrict every query to the appropriate tenant or access scope.


Request
curl -X POST "https://app.inconvo.ai/api/v1/conversations" \
-H "Authorization: Bearer $INCONVO_API_KEY" \
-H "Content-Type: application/json" \
-d $'{
"context": {
"organisationId": 1
}
}'
Response
{
"id": "2c4d3456-e1f7-4d36-a8fd-f5cf15491d00"
}