rerun_workflow

Rerun a CircleCI workflow from start or from the failed job using workflow ID or URL. Choose to restart from the failure point or begin anew based on workflow 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/:vcsType/:orgName/:projectName/:pipelineNumber/workflows/:workflowId
- Workflow Job URL: https://app.circleci.com/pipelines/:vcsType/:orgName/:projectName/:pipelineNumber/workflows/:workflowId/jobs/:buildNumber
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