Skip to main content
POST
Ask about the customer's account (ALPHA)

Authorizations

x-api-key
string
header
required

Headers

x-idempotency-key
string<uuid>
required

Unique key to ensure request idempotency. If the same key is used within a certain time window, the original response will be returned instead of executing the request again.

Path Parameters

customer_id
string
required

Body

application/json
messages
object[]
required

The conversation so far, oldest first.

Required array length: 1 - 40 elements

Response

The assistant's reply

reply
string
required

The assistant's plain-text answer. Advisory only — the assistant cannot execute anything.

conversation_status
enum<string>

How the boundary screen treated this turn. ok is a normal turn; warned means the request was off-topic and the customer was warned but may continue; blocked means the conversation has been terminated (repeated off-topic turns or a manipulation attempt) — the client should stop serving it and offer a fresh chat.

Available options:
ok,
warned,
blocked