Skip to content

/v2/blueprints/{blueprint_id}/versions/{version_id}/
Stable

Request

Retrieves the full configuration for a single, specific version of a blueprint.

Returns the complete settings payload for the given version_id, including whatever apps, files, Wi-Fi networks, and platform-specific restrictions were defined at that point in the blueprint's history.

About Get Blueprint Version This is the endpoint that returns the actual configuration a device receives when converged to a blueprint, since Converge applies a specific blueprint_version_id rather than just a blueprint_id. Use it to inspect exactly what a version will change on a device before rolling it out broadly.

Common Use Cases

Reviewing a version's full settings before using it in a Converge action

Comparing two versions of the same blueprint to understand what changed between them

Best Practices

Always confirm the version_id belongs to the expected blueprint_id, since version IDs are not unique across blueprints in isolation

Review a version's settings in full before converging a large device group to it, since Converge applies the configuration broadly and does not offer a partial rollback

Workflow

Call GET /v2/blueprints/{blueprint_id}/versions/ to find the version_id you need

Call this endpoint with both blueprint_id and version_id to retrieve the full settings

Use the blueprint_id and blueprint_version_id together in a POST to /v2/converge to apply this version to a device

Path
blueprint_idstring, (uuid)required
version_idstring, (uuid)required
cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v2/blueprints/{blueprint_id}/versions/{version_id}/'

Responses

Success

Bodyapplication/json
contentobject(blueprints_BlueprintV2)
messagestring
codestring
Value:201
Response
{
  "content": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "description": "string",
    "comments": "string",
    "version_number": 0,
    "version_id": "9e94c502-ca41-4342-a7f7-af96b444512c",
    "minor_version_number": 0,
    "publish": true,
    "settings": { … },
    "created_by": "string",
    "updated_by": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  },
  "message": "string",
  "code": 201
}