Skip to main content
GET
List Instruction Bots (retired)
Instruction bots are being retired. They are the older stage-based engine: a lead is enrolled into one and walks a sequence of stages. The engine that replaced them — goal bots — has no stages and no enrolment: you tag a lead and the bot handles their replies.Build new work on goal bots. These endpoints stay up for integrations already using them.
Returns every non-archived instruction bot in the workspace, newest first. No query parameters.

Authentication

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

Example

Success (200 OK)

The response key is goalBots, not instructions — a historical name from before the engines split. These are instruction bots, and their ids are not interchangeable with goal bot ids: the two live in different collections.

Response

object[]
Non-archived instruction bots, newest first.

Errors