MUmuxinc
Directives

List directive runs

Changed on

Returns a paginated list of runs for a directive, newest first. Runs are retained for 30 days.

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

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_...).

Query parameters

limitinteger

Maximum number of results to return (default 25, max 100).

pageinteger

Page number, 1-indexed (default 1).

Response

V1 directive runs

total_row_countinteger required

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