// Machines

List a machine's environments

Return the environments one machine is currently assigned to.

GET/api/machine/environments

Description

Returns the environments a single machine is assigned to. The same set is visible from the workspace side on List machines; this endpoint is the cheaper read when you already hold a machineId and only want that one machine.

A machine only takes part in a deployment to an environment it is assigned to, so this list is what decides whether a given deployment will reach it.

Parameters

NameInTypeRequiredDescription
machineId query string yes ID of the machine, from List machines.

Errors

StatusMeaning
400 Invalid machineId. A machine that belongs to another organization is reported the same way as one that does not exist.
401 Missing or invalid Basic auth credentials, or the service account lacks permission to manage machines in this workspace.