---
title: "Update an agent bot"
method: PATCH
path: "/platform/v1/agent_bots/{id}"
tags: ["Bots"]
---

# Update an agent bot

`PATCH /platform/v1/agent_bots/{id}`

## Request

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

Update an agent bot's attributes

## Request body

- PlatformAgentBotCreateUpdatePayload
  - `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
  - `account_id` integer: The account ID to associate the agent bot with
  - `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

## 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)