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

# Update an agent bot

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

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.net/chatwoot/apis/chatwoot-2.md) · [All operations](https://skmtc.net/chatwoot/apis/chatwoot-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chatwoot/chatwoot-2/revisions/f34a278f2713/schema)