{
  "slug": "circleci-project-trigger-update-and-delete-e118b112fe1e",
  "title": "circleci project trigger update and delete",
  "tools": [
    "circleci"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-10-28T15:57:37.000Z",
  "announced_at": "2026-10-28T15:57:37.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When changing an existing trigger, run `circleci project trigger update` with at least one setting flag; to remove it, run `circleci project trigger delete` by trigger ID.",
    "examples": [
      "circleci project trigger update <trigger-id> --event-preset <preset> --config-ref <ref> --checkout-ref <ref> --json",
      "circleci project trigger delete <trigger-id> --force"
    ],
    "gotchas": [
      "Version: v1.12.0",
      "Non-interactive: Delete prompts for confirmation; `--force` skips the prompt for scripts.",
      "Non-interactive: Update supports `--json` for JSON output.",
      "--event-preset <preset>: Choose the trigger event filter preset.",
      "--config-ref <ref>: Git ref for fetching config; applies when config repo differs from event source repo.",
      "--checkout-ref <ref>: Git ref for checkout; applies when checkout repo differs from event source repo.",
      "--enable / --disable: Resume or pause the trigger; mutually exclusive.",
      "--json: Output the update response as JSON.",
      "--force: Skip delete confirmation prompt.",
      "`--enable` and `--disable` are mutually exclusive.",
      "Only flags passed to update are sent; passing no update flags is a bad-arguments error.",
      "The event source cannot be updated because it is fixed at creation.",
      "Neither command requires a project; both address the trigger by ID.",
      "Delete confirms in a terminal and requires `--force` otherwise."
    ]
  },
  "why_it_matters": "Manage an existing project trigger from the CLI by updating its settings or deleting it by trigger ID.",
  "before": "Use `circleci project trigger list` and `circleci project trigger create`; trigger update and delete were not available.",
  "sources": [
    "https://github.com/CircleCI-Public/circleci-cli/releases/tag/v1.12.0",
    "https://github.com/CircleCI-Public/circleci-cli/pull/1951",
    "https://github.com/CircleCI-Public/circleci-cli/blob/v1.12.0/internal/cmd/root/testdata/help/circleci/project/trigger/update.txt",
    "https://github.com/CircleCI-Public/circleci-cli/blob/v1.12.0/internal/cmd/root/testdata/help/circleci/project/trigger/delete.txt"
  ],
  "rank": 0.98044,
  "review_state": "approved",
  "provenance": {
    "run_id": "daily-20261028-20",
    "verdict_id": "daily-20261028-20:daily-20261028-20-d525e4fbc2f5fb83-3:gate",
    "evidence_hash": "57d7d86c4f3c734efa1a63f8222e2aafb4ea567c16163b41a7cc00e0a8d69178"
  }
}