Todas as coleções

Introdução

O Buildprint expõe uma API REST para implantar e gerenciar agentes, revisões de código, automações e testes de projeto para seus aplicativos Bubble.

A API REST pública está atualmente em beta. Os endpoints já estão disponíveis, mas a área de superfície pode mudar conforme o produto evolui.

URL Base

A API REST está exposta em:

https://api.buildprint.ai/api/public/v1

Esquema OpenAPI

curl https://api.buildprint.ai/api/public/v1/openapi.json

Criar um token

  1. Peça a um administrador do workspace para abrir Agent > Integrations > API no Buildprint.

  2. Crie um token de API REST e dê a ele um nome descritivo.

  3. Armazene o token bp_ retornado com segurança. Ele é exibido apenas uma vez.

  4. Envie o token em cada solicitação autenticada como Authorization: Bearer bp_...

Os tokens podem ter escopo para todos os projetos no workspace ou para projetos específicos.

Início rápido

BASE_URL="https://api.buildprint.ai/api/public/v1"
TOKEN="bp_your_workspace_token"

curl --request POST "$BASE_URL/agents" \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "appId": "your-bubble-app-id",
    "prompt": "Inspect the checkout flow and tell me why the webhook retry path fails.",
    "model": "buildprint-gpt-5.3-codex"
  }'

curl --request GET "$BASE_URL/agents/<agentId>" \
  --header "Authorization: Bearer $TOKEN"

Autenticação e escopo

  • Os tokens da API REST têm escopo para um único workspace.

  • Um token só pode ser usado para IDs de aplicativos de projetos Buildprint verificados dentro desse workspace.

  • Revogar um token na UI do Buildprint interrompe todas as solicitações futuras imediatamente.

Modelos e propriedade de execução

  • Modelos hospedados no Buildprint usam o saldo de créditos do workspace e podem ser executados sem userEmail.

  • Modelos de provedores conectados exigem userEmail de um membro do workspace que possua credenciais de provedor ativas conectadas no workspace Buildprint.

  • Os valores de esforço de raciocínio são none, low, medium e high. O padrão é medium.

  • Os valores de permissão são read_only e allow_edits. O padrão é read_only.

Status

  • queued: a execução foi aceita e está aguardando para ser executada.

  • running: o Buildprint está executando ativamente a execução.

  • completed: o agente ou a revisão terminou com sucesso.

  • error: a execução terminou com um erro. Consulte lastError quando disponível.

Webhooks de conclusão

As solicitações de criação de agente e revisão de código podem incluir completionWebhookUrl. Quando fornecido, o Buildprint aguarda a execução atingir um estado terminal e envia um payload JSON para o seu endpoint.

  • Execuções de agentes independentes enviam agent.completed.

  • Execuções de revisão de código enviam review.completed.

  • Se o seu webhook retornar uma resposta não-2xx, o Buildprint tenta a solicitação novamente.

Respostas de erro

Cada resposta de erro inclui uma string de erro. Algumas respostas também incluem um código legível por máquina e, para verificações de plano, um motivo.

Erros comuns incluem:

  • 401 Unauthorized: token bearer ausente ou inválido.

  • 402 api_access_required: o plano do workspace não inclui acesso à API.

  • 402 insufficient_paid_credits: um modelo hospedado no Buildprint foi solicitado, mas o workspace não possui créditos pagos suficientes.

  • 400 user_email_required: um modelo de provedor conectado foi solicitado sem userEmail.

  • 403 user_not_workspace_member: o userEmail fornecido não é membro do workspace.

  • 403 missing_provider_credentials: o usuário fornecido está no workspace, mas não possui credenciais ativas para o provedor solicitado.

Isso foi útil?