Obter o status do agente e o histórico recente

Retorna o estado atual, os metadados do ciclo de vida e o histórico recente da conversa para uma execução de agente criada via REST.

GET /api/public/v1/agents/{agentId}

Token Bearer

curl 'https://api.buildprint.ai/api/public/v1/agents/agent_01JXY9AZK4KV?historyLimit=100' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "agentId": "agent_01JXY9AZK4KV",
  "kind": "agent",
  "status": "queued",
  "appId": "app_01JXY9AZK4KV",
  "projectId": "project_01JXY9AZK4KV",
  "projectName": "example",
  "reviewId": "review_01JXY9AZK4KV",
  "model": "claude-opus-4.6",
  "reasoningEffort": "example",
  "permission": "read_only",
  "permittedBranches": [
    "example"
  ],
  "createdAt": 1,
  "updatedAt": 1,
  "completedAt": 1,
  "lastError": "example",
  "history": [
    {
      "id": "id_01JXY9AZK4KV",
      "sequence": 1,
      "role": "user",
      "content": "example",
      "toolName": "example",
      "toolParameters": "example",
      "attachments": [
        {}
      ],
      "createdAt": 1
    }
  ],
  "lifecycle": {
    "conversationState": "draft",
    "sandboxState": "none",
    "queuedTurnCount": 1,
    "lastLifecycleEventAt": 1
  }
}

Agente encontrado

Parâmetros de caminho

· 1

agentId string obrigatório

Identificador da conversa do agente a ser recuperada.

Parâmetros de consulta

· 1

historyLimit integer · min: 1· max: 500· padrão: 100

Número máximo de itens recentes do histórico a serem retornados. O padrão é 100, com limite máximo de 500.

Parâmetros de caminho

Parâmetros de consulta

Respostas