---
title: "Update an agent bot"
method: PATCH
path: "/v1/workspaces/{workspace_id}/agent_bots/{id}"
tags: ["Bot installations"]
---

# Update an agent bot

`PATCH /v1/workspaces/{workspace_id}/agent_bots/{id}`

## Request

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

Update an agent bot's attributes

## Request body

- AgentBotCreateUpdatePayload
  - `name` string: The name of the agent bot
  - `description` string: The description of the agent bot
  - `outgoing_url` string: The webhook URL for the bot
  - `avatar` string, binary: Send the form data with the avatar image binary or use the avatar_url
  - `avatar_url` string: The url to a jpeg, png file for the agent bot avatar
  - `bot_type` integer: The type of the bot (0 for webhook)
  - `bot_config` object: The configuration for the bot

## Response `200`

Success

- AgentBot
  - `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)