Listar agentes

Liste suas conversas com agentes, da mensagem mais recente para a mais antiga. Com um filtro de status ou launchedBy, da criação mais recente para a mais antiga.

GET /api/v1/agents

Token Bearer

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
}

Sucesso

Parâmetros de consulta

· 7

appId string · min length: 1

O ID do app Bubble ou o ID do projeto Buildprint.

status string · enumeração

valores

running
needs_input
idle
error

type string · enumeração

valores

general
review
linear
slack
subagent
side_chat

archived boolean · padrão: false

Liste agentes arquivados em vez dos abertos.

launchedBy string · min length: 1

Somente agentes iniciados por este agente.

cursor string | null

O cursor da página anterior. Omita-o na primeira página.

limit integer · min: 1· max: 100· padrão: 25

Tamanho da página, até 100.

Parâmetros de consulta

Respostas