Deployment Rings

Phased rollout scheduling for update deployments

📄️ Get available phase presets

Returns all available rollout phase presets (conservative, moderate, aggressive, immediate).

Returns list of IANA timezones and the server's current timezone.

Returns rollout status, phase progression, execution statistics, and next deployment window for all rings.

Returns deployment window events for a date range, grouped by date. Includes execution history and skip status.

Adds a date to the ring's exclusion dates, preventing deployment on that day.

Removes a previously skipped date from exclusion dates.

Creates a deployment ring with rollout phases, deployment windows, emergency controls, and auto-reboot settings. Maximum 25 per tenant.

Returns all deployment rings for the tenant with assigned policies and schedule summaries.

Creates a deployment ring using a predefined phase preset (conservative, moderate, aggressive, immediate).

Creates a deployment ring from an exported JSON definition. Imported rings start as inactive.

Returns a deployment ring with assigned policies and schedule/phase summaries.

Updates fields on a deployment ring. Phase percentages must be increasing and final phase must be 100%.

Deletes a deployment ring.

Creates a copy of an existing deployment ring with a new name.

Replaces the ring's rollout phases with a preset configuration.

Returns all policies associated with a deployment ring.

Returns paginated deployment executions with optional filters by ring, status, phase, and agent.

Returns aggregate statistics for deployment executions over a time range.

Returns details of a single deployment execution.

Cancels a pending or in-progress deployment execution.

Sends a reboot command to the agent associated with a deployment execution.