Cron expression the schedule fires on, interpreted in timezone. Rejected if unparseable or if its tightest interval is under the minimum allowed.

IANA timezone the cron is interpreted in (e.g. America/New_York). Defaults to UTC.

Id of an existing launch run whose stored config this schedule copies. Mutually exclusive with the inline launch spec; provide exactly one. The caller must be able to view the launch run's workspace.

The plugin to install and the skill to run. A value without a file: prefix means a registry ref (either a full workspace/plugin[@version] or a bare plugin[@version] name resolved across the workspaces the caller can see); a value with a file: prefix means a local plugin path inside the cloned repo (e.g. file:apps/cli/plugins/agent-enablement). Either form may carry a trailing #skill selector (e.g. workspace/plugin@1.0.0#implement-ticket or file:apps/cli/plugins/agent-enablement#implement-ticket) that installs the whole plugin and launches the one named skill; it is required when the plugin exposes more than one skill. This is a wire convention: the value is stored verbatim and interpreted downstream by the launch recipe.

Commit SHA or tag pinning the repo snapshot for this run. Pins the checked-out repository, not the sandbox runtime image. Use sandboxSnapshot for the latter.

Operational override selecting the sandbox runtime image the launch run is created from. Distinct from snapshot, which pins the checked-out repository. When omitted the run falls back to the configured default.

Free-text instructions appended to the skill prompt the launch agent runs, mirroring the local --instructions flag. Distinct from the structured inputs channel.

Id of a workspace environment whose sealed .env payload is opened server-side at each run. Must belong to the schedule workspace. Resolved live when each run fires, so environment edits take effect on subsequent runs and a deleted environment fails the launch.