Create Conversation Turn

post/v1/conversations

Send one turn of a conversation. Returns Archie's reply.

Request bodyapplication/json

Field	Type	Description
`messages`	`ChatMessage[]`	— item shape ChatMessage
`message`	`string`	Shorthand for `messages: [{role: 'user', content: ...}]`.
`conversation_id`	`string`	Echo back the id from a prior reply to thread turns.
`client_id`	`string`	Optional client/workspace identifier for scoped answers.
`locale`	`string`	—
`jurisdiction`	`string`	—

Responses

200Assistant reply

Field Type Description

objectrequired string —

conversation_idrequired string —

skillrequired string —

correlation_id string —

messagerequired

object

—

show nested

Field	Type	Description
`role`required	`string`	—
`content`required	`string`	—
`citations`	`Citation[]`	— item shape Citation

400Invalid request body

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

401Authentication required

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

429Rate limit exceeded

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

5XXInternal server error

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

curl https://api.dev.arch.ie/v1/conversations \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "messages": [
         {
           "role": "user",
           "content": "string"
         }
       ],
       "message": "string",
       "conversation_id": "string",
       "client_id": "string",
       "locale": "string",
       "jurisdiction": "string"
     }'