{
  "slug": "pulumi-stack-schedule-commands-manage-deployment-schedules-bf462e353a39",
  "title": "pulumi stack schedule commands manage deployment schedules",
  "tools": [
    "pulumi"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-05-18T16:31:27.000Z",
  "announced_at": "2026-05-18T16:31:27.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When inspecting or maintaining a Pulumi stack’s scheduled deployment actions, use `pulumi stack schedule get|list|new|edit|remove` with the schedule ID and schedule-kind-specific options as needed.",
    "examples": [
      "pulumi stack schedule get <schedule-id> [--stack <stack>] [--output default|json]\npulumi stack schedule list [--stack <stack>] [--count <N>] [--output default|json]",
      "pulumi stack schedule new --kind raw --operation refresh --cron '0 */4 * * *'\npulumi stack schedule new --kind drift --cron '0 */4 * * *' --auto-remediate\npulumi stack schedule new --kind ttl --once 2027-01-01T00:00:00Z --delete-after-destroy",
      "pulumi stack schedule edit <schedule-id> --cron '0 */6 * * *'\npulumi stack schedule remove <schedule-id> --yes"
    ],
    "gotchas": [
      "Version: v3.241.0",
      "<schedule-id> (required): Schedule identifier used by `get`, `edit`, and `remove`.",
      "--kind (required): Schedule kind: `raw`, `drift`, or `ttl`.",
      "--cron (required): UTC cron expression; required for drift and one of `--cron` or `--once` for raw. Mutually exclusive with `--once` for raw. On edit, valid for raw and drift.",
      "--once (required): ISO 8601 one-time execution timestamp; required for TTL and one of `--once` or `--cron` for raw. Mutually exclusive with `--cron` for raw. On edit, valid for raw and TTL.",
      "--operation (required): Raw-only Pulumi operation: `update`, `preview`, `refresh`, or `destroy`.",
      "--auto-remediate: Drift-only; automatically run a remediation update when drift is detected.",
      "--delete-after-destroy: TTL-only; delete the stack from Pulumi Cloud after successfully destroying its resources.",
      "--stack: Stack name; defaults to the current stack.",
      "--count: List at most the first N schedules; 0 (default) shows all.",
      "--output: Output format: `default` or `json`; defaults to `default`.",
      "--yes: For `new`, skip prompts and fail if required values are missing. For `remove`, skip confirmation prompts.",
      "--schedule-id argument to `edit` (required): Identifies the schedule to edit; only passed fields change, and other fields are preserved.",
      "Prerequisite: The stack must have deployment settings configured before creating a schedule.",
      "Docs conflict: The official CLI pages read are generated for Pulumi CLI v3.270.0, newer than the card’s v3.241.0 version. The pages document the same five subcommands; no differing behavior was established."
    ]
  },
  "why_it_matters": "Inspect or maintain scheduled deployment actions for a Pulumi stack.",
  "before": "Before v3.241.0, these five schedule subcommands had not yet been added to the CLI, according to the release note.",
  "sources": [
    "https://github.com/pulumi/pulumi/releases/tag/v3.241.0",
    "https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_get/ ; https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_list/",
    "https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_new/",
    "https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_edit/ ; https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_remove/",
    "https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_get/ ; https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_edit/ ; https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_remove/",
    "https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_new/ ; https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_edit/",
    "https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_get/",
    "https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_list/",
    "https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_new/ ; https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_remove/",
    "https://www.pulumi.com/docs/iac/cli/commands/pulumi_stack_schedule_edit/"
  ],
  "rank": 0.98036,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-20261016",
    "verdict_id": "wave1b-20261016:wave1b-20261016-324393f6bc5e4721-3:gate",
    "evidence_hash": "cb2114e220895d619c9aff2d08a948203ac1670a16a9148199165713324db9ff"
  },
  "review": {
    "draft_hash": "a9b23df11e08c95855b1e79b883ae2b3885e5f960cc3855d02f5ae115ed57401",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-20261016:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.98 >= 0.9; 2 needed) and Jev gave 0.76 (>= 0.6 needed)."
  }
}