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.

Query Parameters

  • state
    Type: enum

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

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

  • workspace
    Type: integer

    Workspace the bot belongs to

  • search
    Type: string

    Case-insensitive match on the bot name

  • channel_family
    Type: enum

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

    values
    landbotwhatsappfacebookapichat
  • order
    Type: "-last_published_at" or "-created_at" or "name"enum

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

  • page
    Type: integer
    min:  
    1

    Integer numbers.

  • page_size
    Type: integer
    min:  
    1
    max:  
    100

    Integer numbers.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/bots
curl 'https://api.landbot.io/v0-alpha/bots?state=active&channel_family=landbot&order=-last_published_at&page=1&page_size=20' \
  --header 'Authorization: Token YOUR_AGENT_TOKEN'

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "string",
      "channel_family": "landbot",
      "state": "active",
      "required_tier": "sandbox",
      "builder_version": "string",
      "is_active": true,
      "preview_only": true,
      "is_published": true,
      "workspace": 1,
      "created_at": "2026-09-16T09:18:19",
      "edited_at": "2026-09-16T09:18:19",
      "edited_by": {
        "id": 1,
        "name": "string"
      },
      "last_published_at": "2026-09-16T09:18:19",
      "published_by": {
        "id": 1,
        "name": "string"
      }
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "page_size": 1
  }
}

A page of bots