Skip to main content
Agents are the workspace entities that answer conversations, use prompts, run rules, and connect to knowledge. The public API still uses /bots in the wire-format paths because that is the current backend contract. Use this family when you need to create an agent, discover botId values for other API calls, or delete an agent.
In the dashboard and most docs, these entities are called agents. In public API paths and some response fields, the same entity appears as bot.

Reference pages

Create agent

POST /v2/bots/public - create a workspace agent by name.

List agents

GET /v2/bots/public - list workspace agents and their serialized prompt text.

Delete agent

DELETE /v2/bots/{id}/public - delete one agent by ID.

Prompts

Read prompt configuration, inspect saved versions, and save new prompt versions for an agent.

Analytics

Fetch performance summaries, chart datasets, knowledge usage, rule analytics, and escalation breakdowns.

Endpoint map