listBots

List bots

GET/v1/admin/bots

Authorization

AuthorizationBearerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Header parameters

x-workspace-idstringrequired

Workspace ID

x-multiple-integrationsstring

Whether the client supports bots with multiple instances of the same integration. Set to "true" to receive integration instances keyed by their alias instead of their id. This header will be removed in the future, and the API will always return multiple instances keyed by alias.

Query parameters

devboolean

If true, only dev bots are returned. Otherwise, only production bots are returned.

tagsobject

Filter by tags

nextTokenstring

Provide the meta.nextToken value provided in the last API response to retrieve the next page of results

sortFieldenum<string>

Sort results by this field

Available options:createdAt,updatedAt

sortDirectionenum<string>

Sort results in this direction

Available options:asc,desc

Response

application/json

Success

The response is of type listBotsResponse · object.

botsobject[]required

metaobjectrequired

Request

curl --request GET \ \
  --url https://api.botpress.cloud/v1/admin/bots \
  --header 'x-workspace-id: <x-workspace-id>' \
  --header 'Authorization: Bearer <token>'

Response

{
  "bots": [
    {
      "id": "string",
      "createdAt": "2025-01-15T12:00:00Z",
      "updatedAt": "2025-01-15T12:00:00Z",
      "name": "string",
      "deployedAt": "2025-01-15T12:00:00Z",
      "tags": {
        "key": "string"
      },
      "type": "studio"
    }
  ],
  "meta": {
    "nextToken": "string"
  }
}