run_playbook
Start a run of an existing Ballet playbook and return a run ID. Use when the user wants to execute a saved automation such as a weekly report, lead enrichment, invoice approval, or ticket triage. Requires a playbook ID from list_playbooks. Pass wait=true to block up to 50s for the final output; otherwise poll with get_run.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "run_playbook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Playbook ID | |
| wait | No | When true, block until the run completes (capped at 50s) and return the final output. When false (default), return the runId immediately for a later get_run. | |
| input | No | Input data for the playbook |