Directives

Get a directive run

Changed on

Retrieves the status, node states, and outcome of a specific directive run. Runs are retained for 30 days.

get/robots/v1/directives/{DIRECTIVE_ID}/runs/{RUN_ID}

Request

  • Base URL
    https://api.mux.com
  • Auth
    • HTTP basic
    • or HTTP bearer

Path parameters

DIRECTIVE_IDstring required

Directive ID returned by directive creation or listing (drv_...).

RUN_IDstring required

Run ID returned by directive run creation or listing (drvrun_...).

Response

V1 directive run

Example response

{
  "data": {
    "id": "drvrun_example",
    "directive_id": "drv_example",
    "subject_id": "asset_example",
    "status": "pending",
    "node_states": [],
    "started_at": 1746403300,
    "completed_at": null
  }
}

Changes