---
title: "Get converge action"
method: GET
path: "/v2/converge/{id}"
tags: ["drift_Converge"]
---

# Get converge action

`GET /v2/converge/{id}`

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

## Path parameters

- `id` string, required

## Response `200`

Converge information

- object
  - `content` DriftConverge
    - `id` string, uuid — Unique converge identifier
    - `device_id` string, uuid — ID of the device
    - `converge_with_provision_option` boolean
    - `blueprint_info` DriftBlueprintsInfo
      - `blueprint_id` string, uuid — Unique blueprint ID
      - `blueprint_version_id` string, uuid — Version ID of blueprint
    - `schedule_type` 'IMMEDIATE' | 'WINDOW' — Following Schedule types are supported ``` * IMMEDIATE: Schedule the command to execcute Immediately * WINDOW: Schedule the command to execute within the given window ```
    - `schedule_args` object
    - `status` 'QUEUED' | 'PROCESSING' | 'IN_PROGRESS' | 'SUCCESS' | 'FAILURE' — Current aggregrated status of the converge action
    - `reason` string — details briefing the reason for current converge status
    - `created_by` string — user id of the user
    - `created_at` string, date-time — Creation timestamp of converge
    - `updated_at` string, date-time — Updation timestamp of converge

## Other responses

- `401` — Authorization information is missing or invalid.
- `404` — Not Found.
- `500` — Internal server error

---

[API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/revisions/e1f64cbb488e/schema)