Get Runbook Tasks
get_runbook_tasksFetch tasks for a specific runbook with optional filtering and sorting, or use forecast mode to return all tasks with timing and dependency data for timeline views.
Instructions
Fetch tasks for a specific runbook, with optional filtering and sorting.
This endpoint has two modes:
Conventional mode: supports filtering, pagination, and sorting.
Forecast mode (forecast=true): returns ALL tasks in a single response regardless of pagination or filters, and includes computed timing fields start_display and end_display, plus predecessor/successor graph relationships. Use for timeline or dependency views.
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": {
"runbook_id": "<runbook_id>"
},
"name": "get_runbook_tasks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order. Example: start_planned or -start_planned (descending). | |
| level | No | Filter by task level. | |
| stage | No | Filter by task stage(s). Allowed: default, startable, in_progress, complete. | |
| user_id | No | Filter to tasks assigned to these user ID(s). | |
| forecast | No | When true, returns all tasks with computed forecast fields (start_display, end_display) and graph info (predecessors, successors). Overrides pagination and filters. | |
| stream_id | No | Filter to tasks in these stream ID(s). | |
| runbook_id | Yes | The unique identifier for the runbook. | |
| fields_task | No | Specific task fields to return (maps to fields[task]). Reduces payload size. Attributes: created_at, comments_count, completion_type, custom_field_values, description, disable_notify, duration, elapsed_duration, is_late, end_actual, end_display (forecast only), end_fixed, end_planned, end_requirements, level, message, name, start_actual, start_display (forecast only), start_requirements, start_fixed, start_planned, start_ready, updated_at, stage. Relationships: predecessors, source_runbook, source_task, successors, stream, task_type. | |
| search_term | No | Filter tasks by search term matched against task name. | |
| has_comments | No | When true, return only tasks that have comments. | |
| task_type_id | No | Filter to tasks of these task type ID(s). | |
| completion_type | No | Filter by completion type. Allowed: complete_normal, complete_skipped, complete_abandoned, complete_auto. | |
| runbook_team_id | No | Filter to tasks assigned to these runbook team ID(s). | |
| source_runbook_id | No | Filter to tasks originating from these source runbook ID(s). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| meta | Yes | Top-level metadata for a list response. | |
| links | Yes | Pagination links for a list response. | |
| included | No |