---
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

---

[API](https://skmtc.net/inconvoai/apis/inconvo-conversations-api.md) · [All operations](https://skmtc.net/inconvoai/apis/inconvo-conversations-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inconvoai/inconvo-conversations-api/revisions/2524aa5bde1f/schema)