Skip to main content
GET
List Bots

Authorizations

Authorization
string
header
required

API key authentication. Include your secret API key (omic_...) in the Authorization header as: Authorization: Bearer <your-api-key>. The public key (omic_pub_...) is only accepted by the endpoints the browser widgets call (/whoami, /test-call, /workflow-test-call, and the chat endpoints); every other endpoint rejects it with 403 This endpoint requires a private API key.

Query Parameters

limit
integer

Maximum number of bots to return (1-100)

Required range: 1 <= x <= 100
offset
integer

Number of bots to skip

Required range: x >= 0
name
string

Filter by bot name (partial match)

created_after
string<date-time>

Filter bots created after this date (ISO 8601 format)

created_before
string<date-time>

Filter bots created before this date (ISO 8601 format)

Response

List of bots retrieved successfully

bots
object[]
required
pagination
object
required