Get converge action

Retrieves the full detail of a single Converge action by its ID.

Returns the blueprint and version targeted, the device it applies to, its current status, and the reason for that status.

About Get Converge Action

This is the detail view behind a single entry in the Converge list, useful for confirming exactly which blueprint_info a device was converged to and why a Converge action succeeded or failed. If a Converge action is marked FAILURE, check /v2/converge/{id}/commands to see which underlying command caused it.

Common Use Cases

Confirming which blueprint version a device was actually converged to

Investigating why a specific Converge action failed

Best Practices

Check the reason field first when a Converge action shows FAILURE, then drill into its commands for the underlying cause

Cross-reference blueprint_info against the intended blueprint_version_id to catch cases where a device converged to an unexpected version

Workflow

Obtain the converge id from the Converge list or from creating a new Converge action

Call this endpoint to review its status and blueprint_info

If status is FAILURE, call /v2/converge/{id}/commands to see the commands fired and their outcomes