Skip to content

Delete Machines

Deletes the specified machines.

Verb DELETE
Endpoint {base-url}/machines
Max Page Size N/A

Request Body

{
  "requestFilter": {
    "machineIdentifiers": ["PROSE1234567890"]
  }
}

Filters Honored

Note

All changes in this request are atomic. If any item fails, the entire batch is rolled back and no changes are made.

Returns

On Success

Response Body

// 204 - No Content

On Error

HTTP Code Error Code Definition
422 MISSING_REQUIRED_DATA No machine identifiers were provided in the request.
403 DATA_ACCESS_VIOLATION One or more of the specified machines belongs to an organization you do not have access to.
404 MISSING_RECORD One or more of the provided machine identifiers did not match any known machines.