Code Reviews

Obter uma revisão de código e o estado do agente vinculado

Retorna metadados da revisão, descobertas agrupadas, comentários de discussão e o estado do agente vinculado para uma revisão de código criada via REST.

GET /api/public/v1/code-reviews/{reviewId}

Obter uma revisão de código e o estado do agente vinculado

curl --request GET \
  --url 'https://api.buildprint.ai/api/public/v1/code-reviews/{REVIEWID}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "reviewId": "<string>",
  "review": {
    "sequence": 1,
    "mergeId": "<string>",
    "status": "open",
    "title": "<string>",
    "description": "<string>",
    "fromVersion": "<string>",
    "toVersion": "<string>",
    "fromVersionLabel": "<string>",
    "toVersionLabel": "<string>",
    "requestedByName": "<string>",
    "requestedByEmail": "<string>",
    "requestedByImage": "<string>"
  },
  "changes": [
    {
      "id": "<string>",
      "type": "change",
      "title": "<string>",
      "description": "<string>",
      "priority": "high",
      "state": "open",
      "createdBy": "ai",
      "createdByEmail": "<string>",
      "createdAt": 1,
      "updatedAt": 1,
      "completedAt": 1
    }
  ],
  "comments": [
    {
      "id": "<string>",
      "type": "change",
      "title": "<string>",
      "description": "<string>",
      "priority": "high",
      "state": "open",
      "createdBy": "ai",
      "createdByEmail": "<string>",
      "createdAt": 1,
      "updatedAt": 1,
      "completedAt": 1
    }
  ],
  "tests": [
    {
      "id": "<string>",
      "type": "change",
      "title": "<string>",
      "description": "<string>",
      "priority": "high",
      "state": "open",
      "createdBy": "ai",
      "createdByEmail": "<string>",
      "createdAt": 1,
      "updatedAt": 1,
      "completedAt": 1
    }
  ],
  "reviewComments": [
    {
      "id": "<string>",
      "parentId": "<string>",
      "authorName": "<string>",
      "authorEmail": "<string>",
      "authorImage": "<string>",
      "body": "<string>",
      "imageUrls": [
        "<string>"
      ],
      "isDeleted": true,
      "editedAt": 1,
      "createdAt": 1
    }
  ],
  "agent": {
    "agentId": "<string>",
    "kind": "agent",
    "status": "queued",
    "appId": "<string>",
    "projectId": "<string>",
    "projectName": "<string>",
    "model": "claude-opus-4.6",
    "reasoningEffort": "none",
    "permission": "read_only",
    "permittedBranches": [
      "<string>"
    ],
    "createdAt": 1,
    "updatedAt": 1
  }
}

Revisão de código encontrada

Authorizations

  • Authorization string obrigatório header

    Token da API REST do workspace prefixado com bp_

Path Parameters

  • reviewId string obrigatório

    Identificador da revisão de código a ser recuperada.

Query Parameters

  • historyLimit integer

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

Response

application/json
  • reviewId string

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

  • review object

    Metadados de resumo para a revisão de código.

    + Show Child Attributes
    • sequence number

      Número de sequência legível por humanos para a revisão dentro do projeto.

    • mergeId string

      Identificador de merge estável para a revisão.

    • status string enum enum

      Status atual da revisão. Allowed values: open, merged, closed.

    • title string | null

      Título da revisão.

    • description string | null

      Descrição opcional da revisão fornecida no momento da criação.

    • fromVersion string

      Branch de origem ou versão sendo revisada.

    • toVersion string

      Branch de destino ou versão sendo comparada.

    • fromVersionLabel string | null

      Rótulo de exibição para a branch ou versão de origem.

    • toVersionLabel string | null

      Rótulo de exibição para a branch ou versão de destino.

    • requestedByName string | null

      Nome de exibição do usuário que solicitou a revisão.

    • requestedByEmail string | null

      E-mail do usuário que solicitou a revisão.

    • requestedByImage string | null

      URL do avatar do usuário que solicitou a revisão.

    • linearIssueId string | null

      ID da issue do Linear vinculada, quando houver uma associada.

    • linearIssueIdentifier string | null

      Identificador da issue do Linear vinculada, quando houver uma associada.

    • provider string enum enum

      Provedor que sustenta o modelo selecionado. Allowed values: claude, openai, gemini, opencode.

    • model string enum enum

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

    • createdAt number

      Timestamp Unix em milissegundos de quando a revisão foi criada.

    • updatedAt number

      Timestamp Unix em milissegundos de quando a revisão foi atualizada pela última vez.

    • completedAt number | null

      Timestamp Unix em milissegundos de quando a revisão foi concluída.

    • mergedAt number | null

      Timestamp Unix em milissegundos de quando a revisão foi marcada como mesclada.

    • closedAt number | null

      Timestamp Unix em milissegundos de quando a revisão foi fechada sem mesclagem.

    • conversationStatus string enum | null

      Estado atual do ciclo de vida da conversa do agente vinculado.

    • conversationErrorCode string | null

      Código de erro interno da conversa vinculada, quando existir.

  • changes[] object array

    Descobertas de alterações anexadas à revisão. Elemento de revisão exibido dentro de uma revisão de código.

    + Show Child Attributes
    • id string

      Identificador único para o elemento de revisão.

    • type string enum enum

      Categoria do elemento de revisão. Allowed values: change, comment, test.

    • title string

      Título curto exibido para o elemento de revisão.

    • description string

      Explicação detalhada da alteração, comentário ou teste.

    • priority string enum | null

      Prioridade atribuída ao elemento, quando existir.

    • state string enum enum

      Se o elemento ainda precisa de atenção. Allowed values: open, completed.

    • createdBy string enum enum

      Se o elemento foi criado por IA ou por um usuário. Allowed values: ai, user.

    • createdByEmail string | null

      E-mail do usuário que criou o elemento, quando disponível.

    • createdAt number

      Timestamp Unix em milissegundos de quando o elemento foi criado.

    • updatedAt number

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

    • completedAt number | null

      Timestamp Unix em milissegundos de quando o elemento foi concluído, se tiver sido concluído.

  • comments[] object array

    Descobertas de comentários anexadas à revisão. Elemento de revisão exibido dentro de uma revisão de código.

    + Show Child Attributes
    • id string

      Identificador único para o elemento de revisão.

    • type string enum enum

      Categoria do elemento de revisão. Allowed values: change, comment, test.

    • title string

      Título curto exibido para o elemento de revisão.

    • description string

      Explicação detalhada da alteração, comentário ou teste.

    • priority string enum | null

      Prioridade atribuída ao elemento, quando existir.

    • state string enum enum

      Se o elemento ainda precisa de atenção. Allowed values: open, completed.

    • createdBy string enum enum

      Se o elemento foi criado por IA ou por um usuário. Allowed values: ai, user.

    • createdByEmail string | null

      E-mail do usuário que criou o elemento, quando disponível.

    • createdAt number

      Timestamp Unix em milissegundos de quando o elemento foi criado.

    • updatedAt number

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

    • completedAt number | null

      Timestamp Unix em milissegundos de quando o elemento foi concluído, se tiver sido concluído.

  • tests[] object array

    Descobertas de testes anexadas à revisão. Elemento de revisão exibido dentro de uma revisão de código.

    + Show Child Attributes
    • id string

      Identificador único para o elemento de revisão.

    • type string enum enum

      Categoria do elemento de revisão. Allowed values: change, comment, test.

    • title string

      Título curto exibido para o elemento de revisão.

    • description string

      Explicação detalhada da alteração, comentário ou teste.

    • priority string enum | null

      Prioridade atribuída ao elemento, quando existir.

    • state string enum enum

      Se o elemento ainda precisa de atenção. Allowed values: open, completed.

    • createdBy string enum enum

      Se o elemento foi criado por IA ou por um usuário. Allowed values: ai, user.

    • createdByEmail string | null

      E-mail do usuário que criou o elemento, quando disponível.

    • createdAt number

      Timestamp Unix em milissegundos de quando o elemento foi criado.

    • updatedAt number

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

    • completedAt number | null

      Timestamp Unix em milissegundos de quando o elemento foi concluído, se tiver sido concluído.

  • reviewComments[] object array

    Comentários de discussão em thread anexados à revisão. Comentário deixado em uma revisão de código.

    + Show Child Attributes
    • id string

      Identificador único para o comentário da revisão.

    • parentId string | null

      Identificador do comentário pai quando este comentário faz parte de uma thread.

    • authorName string | null

      Nome de exibição do autor do comentário.

    • authorEmail string | null

      Endereço de e-mail do autor do comentário.

    • authorImage string | null

      URL do avatar do autor do comentário.

    • body string | null

      Texto do corpo do comentário, ou null se o comentário tiver sido excluído.

    • imageUrls[] string array

      Imagens anexadas ao comentário. URL absoluta para uma imagem anexada ao comentário.

    • isDeleted boolean

      Se o comentário foi excluído.

    • editedAt number | null

      Timestamp Unix em milissegundos de quando o comentário foi editado pela última vez.

    • createdAt number

      Timestamp Unix em milissegundos de quando o comentário foi criado.

  • agent object

    Estado do agente vinculado para a conversa de revisão.

    + Show Child Attributes
    • agentId string

      Identificador opaco para a conversa do agente vinculado.

    • kind string enum enum

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

    • status string enum enum

      Estado atual de alto nível do ciclo de vida 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.

    • 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 recente de conversa 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 uma atividade de ferramenta.

      • toolParameters any | null

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

      • attachments[] oneOf array

        Arquivos e issues vinculadas 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 anyOf

              Tipo MIME para o arquivo anexado.

              + Show Child Attributes
              • anyOf options 2 variants anyOf

                One or more options can apply.

                + Show Child Attributes
                • option 1 string

                  Schema traversal was truncated at maximum depth.

                • option 2 null

                  Schema traversal was truncated at maximum depth.

            • sizeBytes anyOf

              Tamanho do arquivo anexado em bytes.

              + Show Child Attributes
              • anyOf options 2 variants anyOf

                One or more options can apply.

                + Show Child Attributes
                • option 1 number

                  Schema traversal was truncated at maximum depth.

                • option 2 null

                  Schema traversal was truncated at maximum depth.

            • 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 da issue do Linear vinculada.

            • linearIssue anyOf

              Metadados da issue do Linear vinculada quando houver uma associada.

              + Show Child Attributes
              • anyOf options 2 variants anyOf

                One or more options can apply.

                + Show Child Attributes
                • option 1 object

                  Schema traversal was truncated at maximum depth.

                • option 2 null

                  Schema traversal was truncated at maximum depth.

            • 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 vinculado.

      + 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 da sandbox usada 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.