GET /v3/bots
Returns a paginated list of Bots that have a runnable published version.### Filtering - Use `bot_type` to select a Bot type. The public `agent` value means SkillFlow. - Use `keyword` for a case-insensitive Bot name search.### Pagination Use `page` and `limit`. The response includes `total_pages` and `total_count`.
Authentication
HTTPBearer
Parameters
bot_type(query, string, optional) — Optional bot type filter. agent represents SkillFlow.keyword(query, string, optional) — Search keyword (optional).page(query, integer, optional) — Page number to retrieve (starts at 1).limit(query, integer, optional) — Number of Bots per page (max 100).
Responses
200 — Bots returned.
{ "items": [ { "bot_id": "string", "bot_type": "workflow", "name": "string", "description": "string", "published_at": "2026-01-01T00:00:00Z" } ], "page": 0, "limit": 0, "total_count": 0, "total_pages": 0}
400 — Bad Request
{ "code": 123, "msg": "Invalid task_id", "data": null, "ts": 1786634400000, "time": "2026-08-13 18:00:00", "traceId": "a1b2c3d4e5f6"}
500 — Internal Server Error
{ "code": 123, "msg": "Invalid task_id", "data": null, "ts": 1786634400000, "time": "2026-08-13 18:00:00", "traceId": "a1b2c3d4e5f6"}