Growth
List demo conversations (leads)
GET
/ai/conversationsNeedscontent.editEvery conversation the demo agent had, newest first, with the lead's email, AI review and booking state.
Authorization
secretKeyheader
AuthorizationBearer <sk_…>A secret API key from Settings → API keys. It acts with its creator's role.
Query Parameters
filter?stringBucket.
Value in
"all""qualified""unqualified""unreviewed"q?stringSearch goal, summary, email and visitor.
limit?integerPage size (1–200).
Range
1 <= value <= 200offset?integerRows to skip.
Range
0 <= valueResponse Body
OK
application/json- response
conversations*array<>total*integercounts*limit*integeroffset*integerShell
curl -X GET 'https://app.cueston.com/api/ai/conversations'Example Response
JSON
{
"conversations": [
{
"sessionId": "sess_4b1e7a20",
"goal": "string",
"steps": 0,
"outcome": "done",
"qualified": "true",
"userId": "user-123",
"visitorId": "string",
"email": "ada@acme.com",
"name": "Ada Lovelace",
"createdAt": "2026-10-26T09:30:00Z",
"updatedAt": "2026-10-26T09:30:00Z",
"bookingOpenedAt": "2026-10-26T09:30:00Z",
"bookedAt": "2026-10-26T09:30:00Z"
}
],
"total": 3,
"counts": {
"all": 0,
"qualified": 0,
"unqualified": 0,
"unreviewed": 0
},
"limit": 0,
"offset": 0
}Update the demo agent's settingsPATCH
Only the fields you send change; `playbook` is replaced whole. `drives` and `leadCapture` need a paid plan (402). `blockedDomains` entries are normalized (URLs and @domain become the domain). `slackWebhookUrl` must be a Slack incoming webhook (hooks.slack.com); null removes it.
Get one demo conversationGET
The transcript, AI review (summary, intent, sentiment, qualified, next steps), qualification answers and booking state.