Versões

Listar versões sincronizadas

Lista as versões sincronizadas do Buildprint para um app Bubble. Use list_bubble_branches no MCP quando precisar da árvore de ramificações ativa do Bubble; use este endpoint quando precisar de snapshots sincronizados e IDs de versão exatos.

GET /api/public/v1/versions

Listar versões sincronizadas

curl --request GET \
  --url 'https://api.buildprint.ai/api/public/v1/versions' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "versions": [
    {
      "versionId": "<string>",
      "version": "<string>",
      "versionDisplay": "<string>",
      "stage": "pending",
      "syncSource": "manual",
      "lastChange": 1,
      "createdAtMs": 1,
      "createdAt": "<string>",
      "syncedAtMs": 1,
      "syncedAt": "<string>",
      "completedAtMs": 1,
      "completedAt": "<string>"
    }
  ],
  "nextCursor": "<string>"
}

Versões sincronizadas encontradas

Authorizations

  • Authorization string obrigatório header

    Token da API REST do Workspace prefixado com bp_

Query Parameters

  • appId string obrigatório

    ID do app Bubble para o projeto cujas versões sincronizadas devem ser listadas.

  • cursor string

    Cursor de paginação retornado por uma resposta de lista anterior.

  • limit integer

    Número máximo de resultados a retornar.

  • syncedAfter string

    Limite inferior opcional para o tempo de sincronização como um timestamp ISO.

  • syncedBefore string

    Limite superior opcional para o tempo de sincronização como um timestamp ISO.

  • version string obrigatório

    Seletor opcional de branch do Bubble (ID da branch ou rótulo de exibição).

Response

application/json
  • versions[] object array

    Versões sincronizadas correspondentes.

    + Show Child Attributes
    • versionId string

      ID de versão sincronizada exata do Buildprint.

    • version string

      ID canônico da branch do Bubble para esta versão sincronizada.

    • versionDisplay string

      Rótulo de exibição legível da branch do Bubble.

    • stage string enum enum

      Estágio do ciclo de vida da versão sincronizada. Allowed values: pending, stored, indexing, completed, failed.

    • syncSource string enum enum

      Se a versão sincronizada foi criada manualmente ou automaticamente. Allowed values: manual, automatic.

    • lastChange number

      Sequência de alteração do Bubble para a exportação.

    • createdAtMs number

      Timestamp Unix em milissegundos de quando a linha de sincronização foi criada.

    • createdAt string

      Timestamp ISO de quando a linha de sincronização foi criada.

    • syncedAtMs number | null

      Timestamp Unix em milissegundos de quando a sincronização foi concluída, ou null se incompleta.

    • syncedAt string | null

      Timestamp ISO de quando a sincronização foi concluída, ou null se incompleta.

    • completedAtMs number | null

      Alias de syncedAtMs para compatibilidade.

    • completedAt string | null

      Alias de syncedAt para compatibilidade.

    • errorMessage string | null

      Mensagem de falha quando o estágio de sincronização falha, caso contrário, null.

    • fileSha256 string

      Checksum SHA-256 para a exportação armazenada.

    • fileSizeBytes number

      Tamanho da exportação compactada em bytes.

  • nextCursor string | null

    Cursor de paginação para a próxima página, ou null quando não houver mais resultados.