---
title: "POST robots.directive_run.errored"
method: POST
path: "robots.directive_run.errored"
---

# POST robots.directive_run.errored

`POST robots.directive_run.errored` (webhook)

## Payload

- object
  - `type` 'robots.directive_run.errored', required: Type for the webhook event
  - `id` string, required: Unique identifier for the event
  - `created_at` string, date-time, required: Time the event was created
  - `object` object, required
    - `type` string, required
    - `id` string, required
  - `environment` object, required
    - `name` string, required: Name for the environment
    - `id` string, required: Unique identifier for the environment
  - `attempts` object[], required: Attempts for sending out the webhook event
    - `webhook_id` integer: Unique identifier for the webhook
    - `response_status_code` integer: HTTP response status code for the webhook attempt
    - `response_headers` object: HTTP response headers for the webhook attempt
    - `response_body` string, nullable: HTTP response body for the webhook attempt
    - `max_attempts` integer: Max attempts number for the webhook attempt
    - `id` string: Unique identifier for the webhook attempt
    - `created_at` string, date-time: Time the webhook request was attempted
    - `address` string: URL address for the webhook attempt
  - `data` object, required: Directive run object delivered in the Mux webhook event's data field.
    - `id` string, required: Unique run identifier (drvrun_...).
    - `directive_id` string, required: The directive this run belongs to (drv_...).
    - `asset_id` string, required: The Mux asset ID this run targeted.
    - `status` 'pending' | 'dispatching' | 'running' | 'waiting' | 'completed' | 'partial' | 'errored', required: Run status.
    - `node_states` union[], 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.
        - object
          - `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_...).
        - object
          - `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.
        - object
          - `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.
        - object
          - `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.

## Acknowledgement `200`

Return a 200 to indicate that the data was received successfully

---

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