Skip to main content
GET
List Goal Bots
Goal bots and task agents are the same object. The two engines merged; /api/goal-bots and /api/tasks are aliases over one collection and return identical bodies. Every response carries both goalBot and taskAgent (or goalBots and taskAgents) so integrations written against either name keep working.The older stage-based engine moved to /api/instructions and is being retired.
Returns every goal bot in the workspace, newest first, with the built-in Auto Replies bot pinned to the top. There are no query parameters — the workspace comes from your API key.

Authentication

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

Example

Success (200 OK)

The first call from a brand-new workspace creates the default Auto Replies bot, so this endpoint never returns an empty list. That bot is marked isDefault: true and cannot be deleted — set its mode to manual to stop it.

Response

object[]
Every bot in the workspace. Default bot first, then newest first.
object[]
The same array under the pre-rename key. Read either one.

Errors