---
title: "List directive runs"
method: GET
path: "/robots/v0/directives/{DIRECTIVE_ID}/runs"
tags: ["Directives (v0)"]
deprecated: true
---

# List directive runs

`GET /robots/v0/directives/{DIRECTIVE_ID}/runs`

## Request

- Base URL: `https://api.mux.com`
- URL: `https://api.mux.com/robots/v0/directives/{DIRECTIVE_ID}/runs`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

> **Deprecated.**

Deprecated: use `GET /robots/v1/directives/{directive_id}/runs` instead. Returns a paginated list of runs for a directive, newest first. Runs are retained for 30 days.

## Path parameters

- `DIRECTIVE_ID` string, required: Directive ID returned by directive creation or listing (drv_...).

## Query parameters

- `limit` integer: Maximum number of results to return (default 25, max 100).
- `page` integer: Page number, 1-indexed (default 1).

## Response `200`

List of directive runs

- DirectiveRunListResponseV0
  - `data` DirectiveRunDetailV0[], required
    - `run_id` string, required: Unique run identifier (drvrun_...).
    - `subject_id` string, required: The bare Mux asset ID this run targeted.
    - `status` 'pending' | 'dispatching' | 'running' | 'waiting' | 'completed' | 'partial' | 'errored', required: Current run status.
    - `node_states` NodeStateV0[], required: Per-binding status entries, one per binding, in the order the bindings appear in `directive.workflows[]`.
      - union: The state of one workflow binding within a directive run.
        - NodeStateDispatchedV0
          - `reference_id` string, required: Declared binding id from `directive.workflows[]`.
          - `status` 'dispatched', required
          - `workflow_name` 'analyze-structure' | 'summarize' | 'generate-contextual-text' | 'moderate' | 'generate-chapters' | 'find-scenes' | 'edit-captions' | 'translate-captions' | 'translate-audio' | 'ask-questions' | 'find-key-moments' | 'generate-engagement-insights' | 'generate-premium-captions' | 'find-best-thumbnails', required: The Robots workflow for this binding.
          - `job_id` string, required: Workflow job ID (rjob_...).
        - NodeStateFailedV0
          - `reference_id` string, required: Declared binding id from `directive.workflows[]`.
          - `status` 'failed', required
          - `reason` string, required: Human-readable diagnostic explaining why the binding didn't dispatch.
        - NodeStateWaitingForResourcesV0
          - `reference_id` string, required: Declared binding id from `directive.workflows[]`.
          - `status` 'waiting_for_resources', required
          - `workflow_name` 'analyze-structure' | 'summarize' | 'generate-contextual-text' | 'moderate' | 'generate-chapters' | 'find-scenes' | 'edit-captions' | 'translate-captions' | 'translate-audio' | 'ask-questions' | 'find-key-moments' | 'generate-engagement-insights' | 'generate-premium-captions' | 'find-best-thumbnails', required: The Robots workflow for this binding.
        - NodeStateWaitingForSourceWorkflowV0
          - `reference_id` string, required: Declared binding id from `directive.workflows[]`.
          - `status` 'waiting_for_source_workflow', required
          - `workflow_name` 'analyze-structure' | 'summarize' | 'generate-contextual-text' | 'moderate' | 'generate-chapters' | 'find-scenes' | 'edit-captions' | 'translate-captions' | 'translate-audio' | 'ask-questions' | 'find-key-moments' | 'generate-engagement-insights' | 'generate-premium-captions' | 'find-best-thumbnails', required: The Robots workflow for this binding.
          - `source_workflows` string[], required: reference_ids of producer bindings within this directive that must complete before this binding can dispatch.
    - `started_at` integer, required: Unix timestamp (seconds) when the run started.
    - `completed_at` integer, nullable, required: Unix timestamp (seconds) when the run reached terminal state. Null if still in progress.
  - `total_row_count` integer, required: Total number of runs for this directive (within the 30-day retention window).

## Other responses

- `401`: Missing or invalid Mux credentials
- `403`: Robots is not enabled for this environment. Accept the Robots beta terms in the Mux Dashboard to enable access.
- `404`: Directive not found
- `422`: Invalid request parameters
- `500`: Server error

## Changes

- **2026-10-26** `151835caff06`: 1 info
  - endpoint deprecated
- **2026-10-23** `ed6cb570d60c`: 6 warning
  - added the new `analyze-structure` enum value to the `data/items/node_states/items/oneOf[subschema #1: NodeStateDispatched]/workflow_name` response property for the response status `200`
  - added the new `analyze-structure` enum value to the `data/items/node_states/items/oneOf[subschema #3: NodeStateWaitingForResources]/workflow_name` response property for the response status `200`
  - added the new `analyze-structure` enum value to the `data/items/node_states/items/oneOf[subschema #4: NodeStateWaitingForSourceWorkflow]/workflow_name` response property for the response status `200`
  - added the new `generate-contextual-text` enum value to the `data/items/node_states/items/oneOf[subschema #1: NodeStateDispatched]/workflow_name` response property for the response status `200`
  - …2 more
- **2026-10-19** `7e2e5079412d`: 1 breaking, 8 info
  - added `#/components/schemas/NodeStateDispatchedV0, #/components/schemas/NodeStateFailedV0, #/components/schemas/NodeStateWaitingForResourcesV0, #/components/schemas/NodeStateWaitingForSourceWorkflowV0` to the `data/items/node_states/items/` response property `oneOf` list for the response status `200`
  - api operation id `list-directive-runs` removed and replaced with `list-directive-runs-v0`
  - api tag `Directives (v0)` added
  - api tag `Directives` removed
  - …5 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/robots/v0/directives/:DIRECTIVE_ID/runs/get.md)

---

[API](https://skmtc.dev/muxinc/apis/mux-api.md) - [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) - [OpenAPI document](https://skmtc.dev/muxinc/apis/mux-api/revisions/75b4251a1d96?raw)