---
title: "List commands fires for converge action"
method: GET
path: "/v2/converge/{id}/commands"
tags: ["drift_Converge Command"]
---

# List commands fires for converge action

`GET /v2/converge/{id}/commands`

Retrieves the underlying commands that were fired to carry out a specific Converge action.

A single Converge action can result in multiple individual commands being dispatched to a device (for example, installing apps and applying settings); this endpoint lists each of those commands along with its own state.

**About Converge Commands**

Converge doesn't apply a blueprint to a device directly; it decomposes the blueprint's configuration into individual commands and dispatches them. This endpoint exposes that breakdown, which is the most direct way to identify exactly which underlying action caused a Converge action to fail.

**Key Fields / Query Parameters**

command_state — each result's current state, for example Command Failure or Command Success

**Common Use Cases**

Identifying which specific command caused a Converge action to fail, for example a failed app install versus a failed settings change

Auditing the full set of commands a Converge action generated

**Best Practices**

Check each command's command_state and reason individually rather than relying on the Converge action's overall status alone, since one failed command among several is enough to fail the whole Converge action

Cross-reference command_request_id with GET /commands/v0/status/ if you need device-level command status detail beyond what's returned here

**Workflow**

Identify a Converge action with a FAILURE status from the Converge list or detail endpoint

Call this endpoint with that converge id

Review each command's command_state to find the one that failed

## Path parameters

- `id` string, required

## Query parameters

- `limit` number
- `offset` number

## Response `200`

List of commands fired for converge action for the tenant

- object
  - `content` object
    - `count` integer
    - `previous` string
    - `next` string
    - `results` DriftConvergeCommand[]
      - `command_request_id` string, uuid — ID of the command request
      - `command_state` 'Command Queued' | 'Command Initiated' | 'Command Acknowledged' | 'Command In Progress' | 'Command TimeOut' | 'Command Success' | 'Command Failure' | 'Command Scheduled' | 'Command Cancelled' — Current state of the command
      - `reason` string — Details briefing the reason for current command state.
      - `created_at` string, date-time — Creation timestamp of converge command
      - `updated_at` string, date-time — Updation timestamp of converge command

## 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)