rerun_workflow

Rerun a CircleCI workflow from start or from the failed job by providing either a workflow ID or URL. Automate retries and resume workflows based on job status.

Instructions

This tool is used to rerun a workflow from start or from the failed job.

Common use cases:

Rerun a workflow from a failed job
Rerun a workflow from start

Input options (EXACTLY ONE of these TWO options must be used):

Option 1 - Workflow ID:

workflowId: The ID of the workflow to rerun
fromFailed: true to rerun from failed, false to rerun from start. If omitted, behavior is based on workflow status. (optional)

Option 2 - Workflow URL:

workflowURL: The URL of the workflow to rerun
- Workflow URL: https://app.circleci.com/pipelines/////workflows/
- Workflow Job URL: https://app.circleci.com/pipelines/////workflows//jobs/
fromFailed: true to rerun from failed, false to rerun from start. If omitted, behavior is based on workflow status. (optional)

Input Schema

Name	Required	Description	Default
`params`	No

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "params": {
      "additionalProperties": false,
      "properties": {
        "fromFailed": {
          "description": "If true, reruns the workflow from failed. If false, reruns the workflow from the start. If omitted, the rerun behavior is based on the workflow status.",
          "type": "boolean"
        },
        "workflowId": {
          "description": "This should be the workflowId of the workflow that need rerun. The workflowId is an UUID. An example workflowId is a12145c5-90f8-4cc9-98f2-36cb85db9e4b",
          "type": "string"
        },
        "workflowURL": {
          "description": "The URL of the CircleCI workflow or job. Can be any of these formats:\n- Workflow URL: https://app.circleci.com/pipelines/:vcsType/:orgName/:projectName/:pipelineNumber/workflows/:workflowId- Job URL: https://app.circleci.com/pipelines/:vcsType/:orgName/:projectName/:pipelineNumber/workflows/:workflowId/jobs/:buildNumber",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "type": "object"
}

CircleCI MCP Server

rerun_workflow

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from CircleCI MCP Server

Related Tools

MCP directory API