---
title: "List all AgentBots"
method: GET
path: "/v1/workspaces/{workspace_id}/agent_bots"
tags: ["Bot installations"]
---

# List all AgentBots

`GET /v1/workspaces/{workspace_id}/agent_bots`

## Request

- Base URL: `https://api.oxvo.com`
- URL: `https://api.oxvo.com/v1/workspaces/{workspace_id}/agent_bots`
- Auth: API key in header `api_access_token`

List all agent bots available for the current account

## Response `200`

Success

- AgentBot[]: Array of agent bots
  - `id` number: ID of the agent bot
  - `name` string: The name of the agent bot
  - `description` string: The description about the agent bot
  - `thumbnail` string: The thumbnail of the agent bot
  - `outgoing_url` string: The webhook URL for the bot
  - `bot_type` string: The type of the bot
  - `bot_config` object: The configuration of the bot
  - `account_id` number: Account ID if it's an account specific bot
  - `access_token` string: The access token for the bot
  - `system_bot` boolean: Whether the bot is a system bot

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/oxvo/apis/oxvo-apis.md) · [All operations](https://skmtc.dev/oxvo/apis/oxvo-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/oxvo/apis/oxvo-apis/revisions/9a8448cbd1fe?raw)