> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usefini.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Create, list, and delete workspace agents through Fini's public API.

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.

<Info>
  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**.
</Info>

## Reference pages

<CardGroup cols={2}>
  <Card title="Create agent" icon="plus" href="/en/api-reference/create-agent">
    `POST /v2/bots/public` - create a workspace agent by name.
  </Card>

  <Card title="List agents" icon="list" href="/en/api-reference/list-agents">
    `GET /v2/bots/public` - list workspace agents and their serialized prompt text.
  </Card>

  <Card title="Delete agent" icon="trash" href="/en/api-reference/delete-agent">
    `DELETE /v2/bots/{id}/public` - delete one agent by ID.
  </Card>

  <Card title="Prompts" icon="message" href="/en/api-reference/prompts">
    Read prompt configuration, inspect saved versions, and save new prompt versions for an agent.
  </Card>

  <Card title="Analytics" icon="chart-line" href="/en/api-reference/analytics">
    Fetch performance summaries, chart datasets, knowledge usage, rule analytics, and escalation breakdowns.
  </Card>
</CardGroup>

## Endpoint map

| Method   | Path                  | Scope   | Purpose                                   |
| -------- | --------------------- | ------- | ----------------------------------------- |
| `POST`   | `/v2/bots/public`     | `write` | Create a new agent in the workspace.      |
| `GET`    | `/v2/bots/public`     | `read`  | List non-deleted agents in the workspace. |
| `DELETE` | `/v2/bots/:id/public` | `write` | Delete one agent.                         |

## Related endpoint families

| Family                                                | Routes                                                                            | When to use                                                                                 |
| ----------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| [Prompts](/en/api-reference/prompts)                  | `/v2/bots/:id/hc-prompt/.../public`                                               | Read and save the instruction layers for one agent.                                         |
| [Analytics](/en/api-reference/analytics)              | `/v2/bots/:id/hc-analytics/.../public`                                            | Export summary metrics, charts, knowledge usage, rule analytics, and escalation breakdowns. |
| [Conversations](/en/api-reference/list-conversations) | `/v2/hc-interactions/.../public`                                                  | Export conversations, send a new turn, approve a response, or run Fix with AI review.       |
| [Knowledge](/en/api-reference/knowledge)              | `/v2/knowledge/public`, `/v2/hc-articles/.../public`, `/v2/hc-folders/.../public` | Generate, manage, organize, and assign knowledge used by agents.                            |
| [Rules](/en/api-reference/rules)                      | `/v2/hc-rules/.../public`                                                         | Create, publish, restore, or delete Intent Rules and Business Rules assigned to agents.     |