---
title: "Update bot (partial)"
method: PATCH
path: "/bots/{key}"
tags: ["bots"]
---

# Update bot (partial)

`PATCH /bots/{key}`

Update bot fields

## Path parameters

- `key` string, required

## Request body

- object — Update specified bot fields
  - `name` string — Name of the bot
  - `url` string — Bot url
  - `helpUrl` string — Url of the support documentation for the bot
  - `ownerUrl` string — Url of the owner of the bot
  - `active` boolean — If the bot is active
  - `version` string — The version of the bot. Use Semantic Versioning 2.0.0
  - `displayName` string — The name displayed in the bot header.
  - `actions` object[] — Array of objects that contain the name of actions a bot can take and an array of parameters needed for that action
  - `data` object[] — Array of objects that contain the name of data on a bot
  - `owner` string — The name of the user to assign as the owner. Defaults to the user that created it

## Response `200`

Updated field

- BotResponse — A response for information about a bot
  - `id` string — The UUID for the bot
  - `name` string — The unique readable name for the bot
  - `url` string — The URL of the bot server
  - `ui` object — The UI of the bot
    - `name` string — The name of the UI file.
    - `size` integer — The size of the UI file (bytes)
  - `active` boolean — Flag for if a bot is active with communication
  - `actions` object[] — A list of actions that a bot can perform
  - `data` object[] — A list of data that a bot can provide
  - `installedBy` string — The user who installed the bot

## Other responses

- `400` — Bad Request
- `401` — Authentication Error
- `403` — Forbidden
- `default` — Error

---

[API](https://skmtc.dev/salesforce/apis/refocus-api.md) · [All operations](https://skmtc.dev/salesforce/apis/refocus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/salesforce/refocus-api/revisions/42c2153b047e/schema)