Pular para o conteúdo principal
POST
/
v1
/
public
/
agents
/
conversations
Create a conversation
curl --request POST \
  --url https://api.quintus.tec.br/v1/public/agents/conversations \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "f3a1...",
  "context": {
    "page": "/pricing"
  },
  "metadata": {
    "campaign": "spring-2026"
  },
  "user_data": {
    "email": "a@example.com",
    "name": "Andre"
  }
}
'
{
  "id": "<string>",
  "agent_id": "<string>",
  "session_token": "<string>",
  "expires_at": "2023-11-07T05:31:56Z",
  "expires_in": 123,
  "created_at": "2023-11-07T05:31:56Z"
}

Autorizações

​
X-API-Key
string
header
obrigatório

Corpo

application/json
​
agent_id
string
obrigatório

ID of the agent to converse with.

​
user_data
User Data · object

End-user identification stored on the conversation (e.g. {name, email, external_id}). Visible in the dashboard and available to the agent runtime when looking up user history. Not injected verbatim into the LLM context.

​
context
Context · object

Free-form key/value pairs injected into the agent's system context for this conversation. Use for page URL, plan tier, language, etc. Keys and values must be JSON-serializable; keep payload small.

​
metadata
Metadata · object

Free-form storage for the integrator. Saved with the conversation and returned on read. Not seen by the agent. Use for your own tracking IDs, campaign tags, audit fields, etc.

Resposta

Successful Response

​
id
string
obrigatório

Conversation identifier.

​
agent_id
string
obrigatório
​
session_token
string
obrigatório

Bearer token to authenticate subsequent calls in this conversation.

​
expires_at
string<date-time>
obrigatório
​
expires_in
integer
obrigatório

Seconds until session_token expires.

​
created_at
string<date-time>
obrigatório