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

# Get a directive run

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

## Request

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

> **Deprecated.**

Deprecated: use `GET /robots/v1/directives/{directive_id}/runs/{run_id}` instead. Retrieves the status, node states, and outcome of a specific directive run. Runs are retained for 30 days.

## Path parameters

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

## Response `200`

Directive run

- DirectiveRunDetailResponseV0
  - `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.

## 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`: Run 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/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/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/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/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/node_states/items/` response property `oneOf` list for the response status `200`
  - api operation id `get-directive-run` removed and replaced with `get-directive-run-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/:RUN_ID/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)