Description
Removes one environment from the machine, leaving its other environments in place. The machine itself is not deleted and keeps its registration, so it can be assigned again later.
The call is idempotent: removing an environment the machine was never assigned to succeeds and changes nothing, so a pipeline can unassign without checking first.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
machineId |
query | string | yes | ID of the machine, from List machines. |
environmentId |
query | string | yes | ID of the environment to remove from the machine. |
Errors
| Status | Meaning |
|---|---|
400 |
Invalid machineId. A machine that belongs to another organization is reported the same way as one that does not exist. |
400 |
Missing environmentId. |
401 |
Missing or invalid Basic auth credentials, or the service account lacks permission to manage machines in this workspace. |