Retrieves a paginated list of every version created for a specific blueprint.

Each blueprint can have multiple versions as its configuration evolves over time; this endpoint returns them all, with filters available for version number, publish status, and specific apps, files, or Wi-Fi networks referenced within a version's settings.

About Blueprint Versions

A blueprint's actual device configuration lives on its versions, not on the blueprint record itself. Versions let you iterate on a blueprint's settings (apps, files, restrictions, and so on) while keeping a history of what changed and when. Devices are converged to a specific blueprint_version_id, not just a blueprint_id, so this endpoint is the standard way to find the version currently in use or the version you intend to publish next.

Key Fields / Query Parameters

version_number — filters results to a specific version number

publish — filters by publish status

settings__android__app_id — returns versions that include the given app in their settings

ordering — orders results by one or more fields such as version_number or minor_version_number; prefix a field with a minus sign to reverse order, combine multiple fields with a comma

Common Use Cases

Finding the latest published version of a blueprint before converging devices to it

Auditing how a blueprint's app or Wi-Fi network settings have changed across versions

Confirming which blueprint versions reference a specific app before removing that app from the tenant

Best Practices

Filter by publish to distinguish draft versions from versions that are live and available for Converge

Use the settings__android__app_id and similar filters to find every version affected before making a breaking change to a shared resource

Workflow

Call this endpoint with the blueprint_id to list its versions

Identify the version_id of the version you need, typically the latest published one

Call GET /v2/blueprints/{blueprint_id}/versions/{version_id}/ for that version's full settings

Use the version_id in a Converge request to apply it to devices