// Environments

Create an environment

Create a new deployment environment in a workspace.

POST/api/environment

Description

Creates an environment. Environments group machines and cloud targets that receive deployments together.

Parameters

NameInTypeRequiredDescription
workspaceId body string yes ID of the workspace.
name body string yes Environment name (must be unique within the workspace).
sortOrder body number no Display order in the UI.
color body string no Hex color used for the environment chip.

Errors

StatusMeaning
400 Invalid workspaceId or validation failure (e.g. duplicate name).
401 Missing or invalid Basic auth credentials, or the service account lacks the required role.