Versions

List synced versions

Lists completed Buildprint synced versions for a specific Bubble branch, ordered by sync time descending. Use list_bubble_branches in MCP when you need the live Bubble branch tree.

GET /api/public/v1/versions

List synced versions

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>"
}

Synced versions found

Authorizations

  • Authorization string required header

    Workspace REST API token prefixed with bp_

Query Parameters

  • appId string required

    Bubble app ID for the project whose synced versions should be listed.

  • cursor string

    Pagination cursor returned by a previous list response.

  • limit integer

    Maximum number of results to return.

  • syncedAfter string

    Optional lower bound for sync time as an ISO timestamp.

  • syncedBefore string

    Optional upper bound for sync time as an ISO timestamp.

  • version string required

    Bubble branch selector (branch ID or display label).

Response

application/json
  • versions[] object array

    Matching synced versions.

    + Show Child Attributes
    • versionId string

      Exact Buildprint synced version ID.

    • version string

      Canonical Bubble branch ID for this synced version.

    • versionDisplay string

      Human-readable Bubble branch display label.

    • stage string enum enum

      Lifecycle stage of the synced version. Allowed values: pending, stored, indexing, completed, failed.

    • syncSource string enum enum

      Whether the synced version was created manually or automatically. Allowed values: manual, automatic.

    • lastChange number

      Bubble change sequence for the export.

    • createdAtMs number

      Unix timestamp in milliseconds when the sync row was created.

    • createdAt string

      ISO timestamp when the sync row was created.

    • syncedAtMs number | null

      Unix timestamp in milliseconds when the sync completed, or null if incomplete.

    • syncedAt string | null

      ISO timestamp when the sync completed, or null if incomplete.

    • completedAtMs number | null

      Alias of syncedAtMs for compatibility.

    • completedAt string | null

      Alias of syncedAt for compatibility.

    • errorMessage string | null

      Failure message when the sync stage is failed, otherwise null.

    • fileSha256 string

      SHA-256 checksum for the stored export.

    • fileSizeBytes number

      Compressed export size in bytes.

  • nextCursor string | null

    Pagination cursor for the next page, or null when there are no more results.