Create schedule
create_scheduleSchedule authoring — create a BRAND-NEW schedule (mints the schedule + its version 1). The definition names a workflow (versioned-slug ref, published/latest), a recurrence (EITHER a 5-field cron + IANA timezone, OR an 'every N minutes/hours' interval), and an optional static input bound as the workflow's $input on every fire; fetch its JSON Schema with get_schedule_definition_schema and author against it. Pass publish=true to activate it (start firing) in one step, or publish later with publish_schedule. (To add a version to a schedule that already exists, use create_schedule_version.)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | Unique per-tenant slug; hierarchical path segments allowed (e.g. reports/daily-summary). | |
| publish | No | If true, immediately publish the version this call creates (the common create-then-publish in one step). Defaults to false; omit to leave the version as an unpublished draft. | |
| definition | Yes | The schedule definition, as a JSON object. Fetch the exact JSON Schema it must satisfy with get_schedule_definition_schema and author against it (or copy an existing one with the get_*_version tool). The owning service validates it on submit. | |
| description | No | What this schedule does (human + LLM-facing prose). | |
| display_name | No | Human-readable name. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | ||
| version | Yes | ||
| published | Yes | ||
| schedule_id | Yes |