# Dispatch Workflow Runs

> Perform Dispatch Workflow Runs through GenHealth.

Source: [https://genhealth.ai/docs/workflows/integrations/gen-health/genhealth_dispatch_workflow_runs](https://genhealth.ai/docs/workflows/integrations/gen-health/genhealth_dispatch_workflow_runs)

Integration: [GenHealth](https://genhealth.ai/docs/workflows/integrations/gen-health.md)

- Handler: `genhealth_dispatch_workflow_runs`

## Inputs

- `items` — Items (json, required)
  Required JSON value.
- `target_route` — Target Route (text, required)
  Required text value.
- `max_dispatches` — Max Dispatches (number)
  Optional numeric value.
- `event_batch_size` — Event Batch Size (number)
  Optional numeric value.
- `concurrency_key_prefix` — Concurrency Key Prefix (text)
  Optional text value.
- `per_item_concurrency_key_fields` — Per Item Concurrency Key Fields (json)
  Optional JSON value.
- `lock_source` — Lock Source (text)
  Optional text value.
- `trigger_data_extra` — Trigger Data Extra (json)
  Optional JSON value.
- `user_sub` — User Sub (text)
  Optional text value.
- `allow_direct_fallback` — Allow Direct Fallback (boolean)
  Optional true-or-false value.
  Default: `true`
- `require_unique_target_route` — Require Unique Target Route (boolean)
  Optional true-or-false value.
  Default: `false`

## Outputs

- `success` — Success
- `target_route` — Target Route
- `items_received` — Items Received
- `dispatch_count` — Dispatch Count
- `remaining_count` — Remaining Count
- `dispatch_limited` — Dispatch Limited
- `max_dispatches` — Max Dispatches
- `dispatched` — Dispatched
- `error` — Error

Output schema completeness: `best_effort_declared`

## Safety

- External effect: `write`
- Confirmation recommended: no
- Retry safe: no
- Dry run supported: no

## Schemas

These schemas are first-pass authoring guidance. Runtime validation remains authoritative.

### Input schema

```json
{
  "type": "object",
  "required": [
    "items",
    "target_route"
  ],
  "properties": {
    "items": {
      "description": "Required JSON value.",
      "x-workflow-field-type": "json"
    },
    "user_sub": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "lock_source": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "target_route": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "max_dispatches": {
      "type": "number",
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "event_batch_size": {
      "type": "number",
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "trigger_data_extra": {
      "description": "Optional JSON value.",
      "x-workflow-field-type": "json"
    },
    "allow_direct_fallback": {
      "type": "boolean",
      "default": true,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "concurrency_key_prefix": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "require_unique_target_route": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "per_item_concurrency_key_fields": {
      "description": "Optional JSON value.",
      "x-workflow-field-type": "json"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "error": {},
    "success": {},
    "dispatched": {},
    "target_route": {},
    "dispatch_count": {},
    "items_received": {},
    "max_dispatches": {},
    "remaining_count": {},
    "dispatch_limited": {}
  },
  "additionalProperties": true
}
```