List Bots
List bots
Query Parameters
If true, only dev bots are returned. Otherwise, only production bots are returned.
Filter bots that have ALL of these integrations installed (by definition name)
Filter bots that have ALL of these plugins installed (by definition name)
Provide the meta.nextToken value provided in the last API response to retrieve the next page of results
Number of items to return per page (default 20, max 100)
Sort results by this field
Value in
- "createdAt"
- "updatedAt"
Sort results in this direction
Value in
- "asc"
- "desc"
Header Parameters
Workspace ID
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.
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/admin/bots" \ -H "x-workspace-id: string"{ "bots": [ { "id": "stringstringstringstringstri", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "name": "string", "deployedAt": "2019-08-24T14:15:22Z", "tags": { "property1": "string", "property2": "string" }, "type": "studio" } ], "meta": { "nextToken": "string" }}{ "bots": [ { "id": "stringstringstringstringstri", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "name": "string", "deployedAt": "2019-08-24T14:15:22Z", "tags": { "property1": "string", "property2": "string" }, "type": "studio" } ], "meta": { "nextToken": "string" }}