Change the plan of many devices

Assigns a plan to up to 20,000 devices at once. The change is applied in the background; follow its progress with the returned id.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Permission: plans:machines:manage on every listed device (all devices must belong to the organization).

One bulk change at a time per organization (409 while another is pending/running; one stuck for more than 30 minutes is marked failed and no longer blocks). Devices deleted after the request are skipped. If it fails midway, the devices already processed keep the new plan. 400 also for machine_ids cannot be empty and non-string ids. 422 expiration: must be after activation.

Path Params
string
required

Organization id

Body Params
string
required

Plan of the organization to assign

machine_ids
array of strings
required

Devices to update (1-20,000; duplicates ignored)

machine_ids*
string
Defaults to now

Plan start, truncated to the second. Unparseable values are treated as omitted.

string

Plan end; must be after activation. Omitted/null = no expiration.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json