Apply Blueprint

Applies a Blueprint to a number of Devices. The contents of the Blueprint configuraiton will be copied and sent to
each one of the Devices.

Optionally, any Firmware attached to the Blueprint can be marked for installation, and any Files can be sent.

Devices can be specified using a list of IDs, a Tag, or a Filter Language Query. An
Operation object will be returned, which can be used to track the
progress of the Files sent to each Device.

Permissions required:

Path / RolePermissionDescription
BLUEPRINT_READ Role-Global role enabling the reading of Blueprints
Device.path or Device.tagWriteWrite access to the Device(s) included in the request
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The company name

Body Params

A method of selecting Devices. Choose only one

deviceIds
array of strings
length between 0 and 500

List of Device IDs which the File(s) should be sent to.

deviceIds
string

Filters objects using the Octave Filter Language

string

A Tag selecting the Devices to send the File(s) to.

blueprintId
object
required
string
length ≤ 20000

A free-form description of the Operation. Supplied by the user as part of
the request which creates the Operation

boolean
Defaults to false

If true, any Files assigned to the Blueprint will be sent to the Device

boolean
Defaults to false

If true, any Firmware assigned to the Blueprint (when different from
the Device Firmware) will be installed on Device

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json