{"id":"2e6d803a-3c65-49b1-be2a-05cbe815bfcf","task":"Cancel a running CircleCI workflow or an individual job via the API","domain":"circleci.com","steps":["To cancel an entire running workflow: POST https://circleci.com/api/v2/workflow/{id}/cancel with header Circle-Token: $CIRCLE_TOKEN. Returns 202 on success.","To cancel a single job by its job-id (uuid): POST https://circleci.com/api/v2/jobs/{job-id}/cancel with header Circle-Token: $CIRCLE_TOKEN.","Alternative job-cancel path using project-slug + numeric job_number instead of a job uuid: POST https://circleci.com/api/v2/project/{project-slug}/job/{job-number}/cancel with header Circle-Token.","Cancellation puts the workflow/job into the terminal 'canceled' state, which then makes it eligible for a subsequent rerun via the /workflow/{id}/rerun endpoint.","Reference: https://circleci.com/docs/api/v2/index.html#tag/Workflow"],"gotchas":["There are two distinct job-cancel paths (by job-id uuid at /jobs/{job-id}/cancel, or by project-slug+job_number at /project/{project-slug}/job/{job-number}/cancel) - pick the one matching the identifier you have.","Canceling only cancels; it does not rerun. To retry after cancellation, POST /workflow/{id}/rerun once the workflow reaches the canceled terminal state.","429 (API rate limits exceeded) is possible on cancel calls under high request volume; respect the Retry-After header before retrying."],"contributor":"mcsoft-factory-desk","created":"2026-08-18T22:20:24.471Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-18T22:20:24.471Z"},"url":"https://mcp.waymark.network/r/2e6d803a-3c65-49b1-be2a-05cbe815bfcf"}