Agentes

Obter status do agente e histórico recente

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

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

Obter status do agente e histórico recente

curl --request GET \
  --url 'https://api.buildprint.ai/api/public/v1/agents/{AGENTID}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "agentId": "<string>",
  "kind": "agent",
  "status": "queued",
  "appId": "<string>",
  "projectId": "<string>",
  "projectName": "<string>",
  "reviewId": "<string>",
  "model": "claude-opus-4.6",
  "reasoningEffort": "none",
  "permission": "read_only",
  "permittedBranches": [
    "<string>"
  ],
  "createdAt": 1
}

Agente encontrado

Authorizations

  • Authorization string obrigatório header

    Token da API REST do workspace prefixado com bp_

Path Parameters

  • agentId string obrigatório

    Identificador da conversa do agente a ser recuperada.

Query Parameters

  • historyLimit integer

    Número máximo de itens do histórico recente a retornar. O padrão é 100 e o limite é 500.

Response

application/json
  • agentId string

    Identificador opaco para a conversa do agente vinculada.

  • kind string enum enum

    Tipo de recurso da API REST representado pela resposta. Allowed values: agent, code_review.

  • status string enum enum

    Estado atual do ciclo de vida de alto nível para a execução assíncrona. Allowed values: queued, running, completed, error.

  • appId string

    ID do app Bubble para o projeto do workspace que esta requisição visa.

  • projectId string

    Identificador opaco para o projeto do workspace.

  • projectName string

    Nome legível por humanos do projeto do workspace.

  • reviewId string | null

    Identificador opaco para a revisão de código.

  • model string enum enum

    Identificador do modelo usado para a execução. 15 allowed enum values.

  • reasoningEffort string enum | null

    Esforço de raciocínio solicitado para o modelo selecionado.

  • permission string enum enum

    Se a execução pode apenas inspecionar o app ou se também tem permissão para fazer edições. Allowed values: read_only, allow_edits.

  • permittedBranches[] string array

    Branches que a execução tem permissão para acessar quando restrições de branch se aplicam.

  • createdAt number

    Timestamp Unix em milissegundos de quando o recurso foi criado.

  • updatedAt number

    Timestamp Unix em milissegundos de quando o recurso foi atualizado pela última vez.

  • completedAt number | null

    Timestamp Unix em milissegundos de quando o recurso foi concluído.

  • lastError string | null

    Última mensagem de erro registrada para a execução.

  • history[] object array

    Histórico de conversa recente para a execução. Mensagem única retornada no histórico do agente ou da revisão.

    + Show Child Attributes
    • id string

      Identificador único para a mensagem do histórico.

    • sequence number

      Número de sequência da conversa para a mensagem.

    • role string enum enum

      Papel normalizado para a mensagem do histórico. 6 allowed enum values.

    • content string | null

      Conteúdo da mensagem quando a mensagem carrega conteúdo textual.

    • toolName string | null

      Nome da ferramenta associada à mensagem quando a mensagem representa atividade de ferramenta.

    • toolParameters any | null

      Argumentos estruturados da ferramenta quando a mensagem representa uma chamada de ferramenta.

    • attachments[] oneOf array

      Arquivos e problemas vinculados anexados à mensagem.

      + Show Child Attributes
      • oneOf options 2 variants oneOf

        Exactly one option applies.

        + Show Child Attributes
        • option 1 object
          + Show Child Attributes
          • id string

            Identificador único para o arquivo anexado.

          • type string

            Tipo de anexo.

          • name string

            Nome de exibição do arquivo anexado.

          • contentType string | null

            Tipo MIME para o arquivo anexado.

          • sizeBytes number | null

            Tamanho do arquivo anexado em bytes.

          • createdAt number

            Timestamp Unix em milissegundos de quando o anexo foi criado.

        • option 2 object
          + Show Child Attributes
          • id string

            Identificador único para o anexo do Linear vinculado.

          • type string

            Tipo de anexo.

          • name string

            Nome de exibição do problema do Linear vinculado.

          • linearIssue anyOf

            Metadados do problema do Linear vinculado quando um está associado.

            + Show Child Attributes
            • anyOf options 2 variants anyOf

              One or more options can apply.

              + Show Child Attributes
              • option 1 object
                + Show Child Attributes
                • id string

                  ID do problema do Linear vinculado. Schema traversal was truncated at maximum depth.

                • identifier string

                  Identificador legível por humanos do problema do Linear. Schema traversal was truncated at maximum depth.

                • url string

                  URL do problema do Linear vinculado. Schema traversal was truncated at maximum depth.

              • option 2 null
          • createdAt number

            Timestamp Unix em milissegundos de quando o anexo foi criado.

    • createdAt number

      Timestamp Unix em milissegundos de quando a mensagem foi criada.

  • lifecycle object

    Resumo do ciclo de vida para a conversa do agente vinculada.

    + Show Child Attributes
    • conversationState string enum enum

      Estado interno do ciclo de vida da conversa vinculada. Allowed values: draft, ready, running_turn, errored, archived.

    • sandboxState string enum enum

      Estado atual do ciclo de vida do sandbox usado pela execução. 6 allowed enum values.

    • queuedTurnCount number

      Número de turnos ainda na fila para execução.

    • lastLifecycleEventAt number | null

      Timestamp Unix em milissegundos para o evento de ciclo de vida mais recente.