Skip to main content
POST
Open a server-owned conversation and take custody of its transcript

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Creating a conversation is the act of opting into server-side transcript custody (ADR-AHK8YT) — there is no implicit persistence path, so this request is the only door in.

Which conversations a caller may touch is decided by the capability middleware and the ownership policy, not here — this only asserts that a caller was authenticated at all.

title
string | null
Maximum string length: 255
phi_mode
enum<string>
Available options:
allow,
redact,
block
agent_version_id
string | null
Maximum string length: 64

Response

The response is of type object.