# nitro_control_delivery

`TOOL nitro_control_delivery`

Approve or control delivery after review. Restarting a paused flow may require a choice for contacts already in progress. revision_id can assert the current draft.

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `target_type` (required)
  Type: string
  
  enum: ["flow","campaign"]

- `target_id` (required)
  Type: integer
  
  minimum: 1

- `expected_brand_sid` (optional)
  Type: string
  
  Optional reviewed-brand assertion. When available, copy meta.current_brand.sid from the reviewed result.
  
  minLength: 1

- `operation` (required)
  Type: string
  
  approve preflights; schedule is campaign-only; delete requires confirm and a never-sent draft.
  
  enum: ["approve","reject","live","schedule","pause","resume","cancel","archive","restore","delete"]

- `scheduled_at` (optional)
  Type: string, date-time
  
  Required for schedule.

- `revision_id` (optional)
  Type: integer
  
  Optional current-draft assertion for flow approve, reject, and live.
  
  minimum: 1

- `resume_mode` (optional)
  Type: string
  
  For paused flows: stop current journeys, or restart waits and continue gradually.
  
  enum: ["new_contacts_only","continue_existing"]

- `confirm_send_to_all` (optional)
  Type: boolean
  
  Explicit all_contacts confirmation for live/schedule.

- `confirm` (optional)
  Type: boolean
  
  Required for delete.

- `idempotency_key` (optional)
  Type: string
  
  Campaign-live retry key; reuse only for the same send.

- `versions` (optional)
  Type: array
  
  See nitro_review_delivery versions.
  
  Items:
    Type: object

- `winner` (optional)
  Type: object

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_control_delivery",
    "arguments": {
        "target_type": "flow",
        "target_id": 1,
        "expected_brand_sid": "string",
        "operation": "approve",
        "scheduled_at": "2024-01-15T09:30:00Z",
        "revision_id": 1,
        "resume_mode": "new_contacts_only",
        "confirm_send_to_all": true,
        "confirm": true,
        "idempotency_key": "string",
        "versions": [
          {}
        ],
        "winner": {}
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_control_delivery",
  "arguments": {
    "target_type": "flow",
    "target_id": 1,
    "expected_brand_sid": "string",
    "operation": "approve",
    "scheduled_at": "2024-01-15T09:30:00Z",
    "revision_id": 1,
    "resume_mode": "new_contacts_only",
    "confirm_send_to_all": true,
    "confirm": true,
    "idempotency_key": "string",
    "versions": [
      {}
    ],
    "winner": {}
  }
});
```

### Python

```python
result = await session.call_tool("nitro_control_delivery", arguments={
  "target_type": "flow",
  "target_id": 1,
  "expected_brand_sid": "string",
  "operation": "approve",
  "scheduled_at": "2024-01-15T09:30:00Z",
  "revision_id": 1,
  "resume_mode": "new_contacts_only",
  "confirm_send_to_all": true,
  "confirm": true,
  "idempotency_key": "string",
  "versions": [
    {}
  ],
  "winner": {}
})
```
