GET
https://app.evoriqa.com/api/v1/chatbotsList chatbots in the workspace
Returns the workspace's chatbots, newest first and cursor-paginated. Each entry carries the public cb_ id the widget embeds with, plus its status.
Requires scope chatbots:read
Note:
Available on every plan
Create a key under Settings → API keys and call it. If you’re a client of an agency or reseller and get 403 API access is not enabled for this workspace., your provider turns the API on for your workspace.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| limit | query | integer 1–200 | Optional | 100 | Maximum number of items to return. Defaults to 100; values above 200 are clamped to 200. |
| cursor | query | string uuid | Optional | — | The nextCursor from the previous page. A malformed cursor is ignored and the first page is returned. |
Request
curl
curl "https://app.evoriqa.com/api/v1/chatbots" \
-H "x-api-key: $EVORIQA_API_KEY"Node.js
const res = await fetch("https://app.evoriqa.com/api/v1/chatbots", {
headers: {
Authorization: `Bearer ${process.env.EVORIQA_API_KEY}`,
},
});
const responseBody = await res.json();Python
import os
import requests
res = requests.get(
"https://app.evoriqa.com/api/v1/chatbots",
headers={"Authorization": f"Bearer {os.environ['EVORIQA_API_KEY']}"},
)
body = res.json()Response
200 OK
{
"success": true,
"data": {
"data": [
{
"id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
"name": "Sales Assistant",
"publicId": "cb_9x2k7m4q",
"status": "active",
"createdAt": "2026-01-15T09:24:00.000Z"
}
],
"nextCursor": null
}
}