Bots

List bots

A page of your bots, newest publication first. order also takes -created_at and name.

state=trashed lists what is in the trash instead of what is in use.

Sorting by when the content last changed is not offered.

get/bots

Request

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

Query parameters

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.

Lifecycle state. Defaults to active, so trashed bots are not listed.

workspaceinteger

Workspace the bot belongs to

searchstring

Case-insensitive match on the bot name

channel_family'landbot' | 'whatsapp' | 'facebook' | 'apichat'

The family the bot runs on. Filtering by channel type is not offered.

order'-last_published_at' | '-created_at' | 'name'

How the page is sorted. -last_published_at is the most recently published first, -created_at the most recently created first, and name alphabetical.

pageinteger
page_sizeinteger

Response

A page of bots

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.