Model
Create a conversation
Create a new conversation
POST
/model/v1/conversations● SupportedRequest body
itemsarray可选Initial items, at most 20 per request. Router support (supported): Verified to take effect.
Verified to take effect.
metadataobject可选Up to 16 string key/value pairs stored with the conversation; keys at most 64 characters and values at most 512. Router support (supported): Verified to take effect.
Verified to take effect.
Returns
200 conversation
Creates a conversation, optionally with initial items (up to 20 per call) and metadata. Conversations are tenant-partitioned; the creating tenant is the only one that can reference it.
Platform errors (auth, rate limits, validation) and OCR errors use problem+json; other model call errors follow the endpoint's own format (OpenAI or Anthropic) — see error codes
Response
HTTP 200
The created conversation
application/json
| Name | Type | Description |
|---|---|---|
| id | string | Id of the conversation, such as `conv_...`; use it as `conversation_id` in conversation calls and as `conversation` in createResponse. |
| object | string | Object type; always `conversation`. |
| created_at | integer | Unix time in seconds at which the conversation was created. |
| metadata | object | Up to 16 string key/value pairs; keys at most 64 characters and values at most 512. |