Bulk Change

posthttps://app.mk.io/api/v1/projects/:project_name/fleet/bulk

Change several resources of one kind at once. kind says what is changed and names lists the resources; the rest of the body is what a PATCH of one of them would contain.

For device, request the same software preload or switch on several devices. Each device is checked against the same rules as updating a single device, so the result is the same as sending one PATCH per device. Only standalone devices and HA workers are accepted; HA controllers and arbiters must be updated individually.

Resources that pass are updated together. If any cannot be updated the status is 422, the ones that could be updated have still been updated, and failed lists the others with their errors. To learn more about devices, read Device Concept.

RBAC Capability Required: fleet.device.create

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_namestringRequired

Request

This endpoint expects an object.

Loading schema details…

Response

200All the devices were updated

Loading schema details…

Errors

400Bad Request

Loading schema details…

401Unauthorized

Loading schema details…

403Forbidden

Loading schema details…

404Not Found

Loading schema details…

422Some devices could not be updated. The others were updated.

Loading schema details…

429Too Many Requests

Loading schema details…

500Internal Server Error

Loading schema details…