# Merge Study Queue Items

> Perform Merge Study Queue Items through GenHealth - Eligibility.

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

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

- Handler: `eligibility_merge_study_vob_queue_items`

## Use in a workflow

Copy this discovered node config, fill params from the input contract, and validate the complete graph. Integration results are available as {{node_id.default.field}}. Check business success before dependent writes; completion alone does not prove business success.

```json

{
  "_group": "GenHealth - Eligibility",
  "params": {
    "contract_mode": "legacy"
  },
  "handler": "eligibility_merge_study_vob_queue_items"
}

```

[Action contracts](https://genhealth.ai/docs/workflows/action-contracts.md) · [Run recovery](https://genhealth.ai/docs/workflows/operations.md)

## Inputs

- `queue_results` — Queue Results (expression, required)
  Required literal value or workflow expression.
- `lane_rules` — Lane Rules (json, required)
  Required JSON value.
- `contract_mode` — Contract Mode (text)
  Optional text value.
  Default: `"legacy"`
- `max_items` — Max Items (number, required)
  Required numeric value.
- `coverage_as_of_date` — Coverage As Of Date (expression, required)
  Required literal value or workflow expression.
- `canary_source_document_id` — Canary Source Document Id (text)
  Optional text value.
- `canary_lane` — Canary Lane (text)
  Optional text value.

## Outputs

- `success` — Success
- `status` — Status
- `items` — Items
- `candidate_count` — Candidate Count
- `scanned_count` — Scanned Count
- `filtered_count` — Filtered Count
- `duplicate_count` — Duplicate Count
- `queue_read_failed_count` — Queue Read Failed Count
- `source_queue_truncated_count` — Source Queue Truncated Count
- `merge_truncated` — Merge Truncated
- `configuration_required_lane_count` — Configuration Required Lane Count
- `canary_status` — Canary Status
- `canary_match_count` — Canary Match Count
- `queue_summaries` — Queue Summaries
- `configuration_required_lanes` — Configuration Required Lanes
- `diagnostics` — Diagnostics

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": [
    "queue_results",
    "lane_rules",
    "max_items",
    "coverage_as_of_date"
  ],
  "properties": {
    "max_items": {
      "type": "number",
      "description": "Required numeric value.",
      "x-workflow-field-type": "number"
    },
    "lane_rules": {
      "description": "Required JSON value.",
      "x-workflow-field-type": "json"
    },
    "canary_lane": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "contract_mode": {
      "type": "string",
      "default": "legacy",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "queue_results": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "coverage_as_of_date": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "canary_source_document_id": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "items": {},
    "status": {},
    "success": {},
    "diagnostics": {},
    "canary_status": {},
    "scanned_count": {},
    "filtered_count": {},
    "candidate_count": {},
    "duplicate_count": {},
    "merge_truncated": {},
    "queue_summaries": {},
    "canary_match_count": {},
    "queue_read_failed_count": {},
    "configuration_required_lanes": {},
    "source_queue_truncated_count": {},
    "configuration_required_lane_count": {}
  },
  "additionalProperties": true
}
```