List agents

List your agent conversations, newest message first. With a status or launchedBy filter, newest created first.

GET /api/v1/agents

Bearer token

curl 'https://api.buildprint.ai/api/v1/agents?appId=app_01JXY9AZK4KV&status=running&type=general&archived=false&launchedBy=example&cursor=example&limit=25' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "items": [
    {
      "id": "id_01JXY9AZK4KV",
      "title": "example",
      "status": "running",
      "type": "general",
      "projectId": "project_01JXY9AZK4KV",
      "projectName": "example",
      "branch": "example",
      "isArchived": true,
      "isUnread": true,
      "createdAt": 1,
      "lastMessageAt": 1
    }
  ],
  "cursor": "example",
  "isDone": true
}

Success

Query parameters

· 7

appId string · min length: 1

The Bubble app ID, or the Buildprint project ID.

status string · enum

values

running
needs_input
idle
error

type string · enum

values

general
review
linear
slack
subagent
side_chat

archived boolean · default: false

List archived agents instead of open ones.

launchedBy string · min length: 1

Only agents started by this agent.

cursor string | null

The cursor from the previous page. Leave it out for the first page.

limit integer · min: 1· max: 100· default: 25

Page size, up to 100.

Query parameters

Responses