Bots

Update settings, or restore from trash

Writes only the fields you send. An empty body answers 400, and so does a field we do not describe.

state: active is how you take a bot out of the trash, and the only value state accepts. Any other write to a trashed bot answers 404, as if it were not there.

patch/bots/{bot_id}

Request

  • Base URL: https://api.landbot.io/v0-alpha
  • URL: https://api.landbot.io/v0-alpha/bots/{bot_id}
  • Auth: one of:
    • API key in header Authorization
    • API key in cookie sessionid
    • HTTP bearer

Request body

namestring
workspaceinteger nullable

The workspace to file the bot under. Send null to file it under none. A workspace that does not exist, or belongs to another brand, is rejected with 422.

is_activeboolean
state'active' | 'trashed'

active is a bot in use. trashed is a bot that has been deleted but is recoverable; it does not serve conversations.

Response

The updated bot

Example response

{
  "data": {
    "created_at": "2026-09-16T09:18:19",
    "edited_at": "2026-09-16T09:18:19",
    "last_published_at": "2026-09-16T09:18:19"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.