Skip to main content
GET
List Task Agents
This is an alias. GET /api/tasks and GET /api/goal-bots are the same route over the same collection and return identical bodies. /api/tasks is not deprecated — it is the name integrations built before the rename already use.
Returns every bot in the workspace, newest first, with the built-in Auto Replies bot pinned to the top. No query parameters.

Authentication

Pass your workspace API key as a Bearer token, or use a Clerk session token.

Example

Success (200 OK)

Both keys are always present. goalBots is what the dashboard and these docs call them; taskAgents is the pre-rename key. Read either.
See List Goal Bots for the full field reference.

Errors