---
title: "Create conversation"
method: POST
path: "/agents/{agentId}/conversations"
tags: ["Conversations"]
---

# Create conversation

`POST /agents/{agentId}/conversations`

## Path parameters

- `agentId` string, required

## Request body

- object
  - `userIdentifier` string, required — Unique identifier for the end-user (1-256 chars). Allowed characters: alphanumeric, underscore, hyphen, period, at symbol.
  - `userContext` object — Optional context key-values for additional filtering/tenancy. Required when User Context status is ENABLED. Must be omitted when User Context status is DISABLED. Requests fail when User Context is UNSET.

## Response `200`

Conversation created

- object
  - `id` string

## Changes

- **2026-02-16** `2c68c14b2d01` — 1 warning
  - changed the pattern of the request property `userIdentifier` from `^[a-zA-Z0-9_\-:.@]+$` to `^[a-zA-Z0-9_\-.@]+$`
- **2026-01-26** `a08c0483f239` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api/changes/agents/:agentId/conversations/post.md)

---

[API](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api.md) · [All operations](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api/revisions/2c68c14b2d01?raw)