Create Runbook
create_runbookCreate a new runbook in a workspace or copy an existing runbook/template with tasks, teams, users, schedules, and status settings.
Instructions
Create a new runbook in a workspace, or as a copy of an existing runbook/template.
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": {
"name": "<name>"
},
"name": "create_runbook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rto | No | Recovery Time Objective (RTO) in seconds (optional). | |
| name | Yes | The name of the new runbook. | |
| status | No | The new RAG status for the runbook (Allowed: off, red, amber, green). | |
| timezone | No | IANA Timezone name (optional). | |
| folder_id | No | ID of the folder to place the new runbook in (optional, relationship field). If omitted, the runbook lands in the workspace's default location. | |
| auto_start | No | Whether to auto-start the runbook once start_scheduled is reached. Auto-started runbooks run in live mode with comms on. | |
| copy_tasks | No | Whether to copy the source's tasks. Defaults to True. | |
| copy_teams | No | Whether to copy the source's teams. Defaults to True. Teams are copied without their members unless copy_users is also True, so keep teams and users together. | |
| copy_users | No | Whether to copy the source's users. Defaults to True. | |
| description | No | An optional description for the runbook. | |
| is_template | No | Whether the runbook is a template (optional, true/false). | |
| rto_end_task | No | ID of the end task for RTO/RTA feature (optional, relationship field). | |
| workspace_id | No | The ID of the workspace to create the runbook in (relationship field). Required unless copy_source_runbook_id is passed. | |
| end_scheduled | No | ISO 8601 timestamp for the runbook's scheduled end. Must be omitted if start_scheduled is not set. | |
| template_type | No | The template type of the runbook. Allowed values: off, default, snippet. | |
| rto_start_task | No | ID of the start task for RTO/RTA feature (optional, relationship field). | |
| master_template | No | Whether this runbook can be used to create app-specific templates from the Workspace Data Sources view. Requires is_template=True; the API rejects setting this on a non-template runbook. Do NOT respond to that rejection by also setting is_template=True in the same or a follow-up call unless the user explicitly asked for the runbook to become a template ā silently converting a live runbook into a template is a significant, hard-to-reverse side effect. Surface the rejection and ask the user instead. | |
| runbook_type_id | No | The ID of the runbook type to associate with this runbook (optional, relationship field). | |
| start_scheduled | No | ISO 8601 timestamp, or the literal string "now", to schedule the runbook's start. Mutually exclusive with a planned start time set elsewhere; the scheduler ignores times in the past. | |
| shift_fixed_times | No | When copying, whether start_fixed/end_fixed task attributes should be recalculated relative to the new runbook's start. | |
| custom_field_values | No | Custom field values to set, including the runbook dashboard fields on the runbook homepage (e.g. Executive summary, Additional notes), the Post-Implementation Review (PIR) and the Incident Review (e.g. Incident Summary, RCA, Lessons Learned). Identify each field by custom_field_id, using the id returned by list_custom_fields with scope="runbook": {"custom_field_id": "123", "value": ...}. A field's internal ``name`` (e.g. "dashboard:incident_review:lessons_learned") can be used instead of the id, but its ``display_name`` ("Lessons Learned") cannot. For select_menu and radiobox fields, pass the option name; for checkboxes, pass a list of option names. Pass "" to clear a field. Values in the response are listed by ``name``, with custom_field_id set to null. | |
| copy_source_runbook_id | No | ID of an existing runbook/template to copy from. When set, this runbook is created as a copy and workspace_id may be omitted. The copy flags below all default to a full clone; only set one to False when the user asks to exclude that part. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| included | No |