---
title: "Update a bot"
method: PUT
path: "/bot/{id}"
tags: ["Bot"]
---

# Update a bot

`PUT /bot/{id}`

Updates fields in a bot.

Only non-null fields are updated. Any missing or null field is ignored.

## Path parameters

- `id` string, required

## Request body

- UpdateBotInput
  - `favorite` boolean, nullable — Whether the bot is favorited
  - `trash` boolean, nullable — Whether the bot is trashed
  - `locked` boolean, nullable — Whether the bot is locked
  - `rescheduling` boolean, nullable — Whether the bot has conversation rescheduling enabled
  - `name` string, nullable — The name of the bot
  - `folderId` string, nullable — The folder ID of the bot
  - `category` string, nullable — The category of the bot
  - `followUpActive` boolean, nullable — Whether the bot does follow-ups
  - `followUpSequences` FollowUpSequenceDto[], nullable — The follow-up sequences of the bot
    - `order` integer
    - `duration` integer
    - `unit` string, nullable
  - `smartFollowUp` boolean, nullable — Whether the bot does smart follow-ups
  - `followUpRepeat` boolean, nullable — Whether the bot repeats the last follow-up sequence
  - `followUpVarianceMinutes` integer, nullable — The variance minutes for the follow-ups
  - `followUpExtraPrompt` string, nullable — The extra prompt for the follow-ups
  - `followUpStates` FollowUpStateInputDto[], nullable — The follow-up states (multi-cadence) for the bot
    - `name` string, nullable
    - `isDefault` boolean
    - `sequences` FollowUpSequenceDto[], nullable
      - `order` integer
      - `duration` integer
      - `unit` string, nullable
    - `repeatFinal` boolean
    - `extraPrompt` string, nullable
    - `order` integer

## Response `200`

Success

- BotDto
  - `id` string, nullable
  - `name` string, nullable
  - `modifiedAt` string, nullable
  - `modifiedBy` string, nullable
  - `versions` BotVersionDto[], nullable
    - `version` string, nullable
    - `name` string, nullable
    - `published` boolean
    - `modifiedAt` string, date-time
    - `modifiedBy` string, nullable
  - `sources` BotSourceDto[], nullable
    - `id` string, nullable
    - `category` string, nullable
    - `key` string, nullable
    - `name` string, nullable
    - `tags` ContactTag[], nullable
      - `name` string, nullable
      - `approveDeny` boolean
      - `id` string, nullable
    - `tagFilterConfig` TagFilterConfig
      - `operator` string, nullable
      - `groups` TagFilterGroup[], nullable
        - `operator` string, nullable
        - `rules` TagFilterRule[], nullable
          - `tagName` string, nullable
          - `tagId` string, nullable
          - `condition` string, nullable
    - `channelList` string[], nullable
    - `personaNameOverride` string, nullable
    - `enabled` boolean
    - `flowVariableValues` object, nullable
  - `personaIds` string[], nullable
  - `favorited` boolean
  - `locked` boolean
  - `reschedulingEnabled` boolean
  - `category` string, nullable
  - `folderId` string, nullable
  - `followUpActive` boolean
  - `followUpSequences` FollowUpSequenceDto[], nullable
    - `order` integer
    - `duration` integer
    - `unit` string, nullable
  - `smartFollowUp` boolean
  - `followUpRepeat` boolean
  - `followUpVarianceMinutes` integer
  - `followUpExtraPrompt` string, nullable
  - `tools` BotToolDto[], nullable
    - `id` string, nullable
    - `type` string, nullable
    - `enabled` boolean
    - `options` BotToolOptions
  - `followUpStates` FollowUpStateDto[], nullable
    - `id` integer
    - `name` string, nullable
    - `isDefault` boolean
    - `sequences` FollowUpSequenceDto[], nullable
      - `order` integer
      - `duration` integer
      - `unit` string, nullable
    - `repeatFinal` boolean
    - `extraPrompt` string, nullable
    - `order` integer

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

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