Skip to main content

Update machine accounts in bulk

POST 
/machine-accounts/v1/bulk-update
experimental

This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint.

Use this API to apply the same JSON Patch to up to 100 machine accounts. The response has one result per requested machine account, in no particular order. Each result has its own HTTP-style status: 200 when the update succeeded, or an error status such as 400 or 404.

Each patch operation must target one of these top-level fields:

  • description
  • subtype
  • environment
  • machineIdentity
  • ownerIdentity
  • manuallyEdited

The request fails with 400 when ids is empty or has more than 100 entries, when jsonPatch is missing, or when a patch operation targets any other field. A patch that changes subtype must only include machine accounts from one source; otherwise every result has status 400.

A caller who owns the machine accounts can update them. Other callers need the idn:mis-account:update right. For a caller without the right, machine accounts they do not own get a result with status 404.

When this capability is not enabled for the tenant, this API returns 403.

Request​

Responses​

One result per requested machine account.