Re-run a workflow run

Run a finished workflow run again: every job, or with failed_only the jobs that did not succeed and the jobs that need them.

POST/repos/{owner}/{name}/actions/runs/{id}/rerun

Needs the Write role or higher.

The run keeps its id; attempt goes up by one.

Authentication: Required. Send an access token as Authorization: Bearer.
MCP tool: rerun_workflow_run, with the same inputs
Also at: POST /repos/{owner}/{name}/actions/runs/{id}/rerun-failed-jobs

Path parameters

Name	Type	Required	Description
`owner`	string	Yes	The workspace that owns the repository.
`name`	string	Yes	The repository’s name.
`id`	string	Yes	The run’s id.

Body parameters

Send a JSON object. Names are snake_case, as in responses; the camelCase spelling is accepted too.

Name	Type	Required	Description
`failed_only`	boolean	No	Only the jobs that did not succeed, and those that need them.

Example request

curl -X POST https://api.g1t.sh/repos/flagon-io/hello/actions/runs/run_01kpx7b3c6d9e2f5g8h1j4k7mr/rerun \
  -H "Authorization: Bearer $G1T_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "failed_only": true
  }'

Example response

A successful request answers 200 with:

{
  "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr",
  "workflow_id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9np",
  "path": ".g1t/workflows/ci.yml",
  "name": "CI",
  "title": "Greeting should name the caller",
  "number": 12,
  "attempt": 2,
  "event": "push",
  "ref": "refs/heads/main",
  "sha": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
  "pull": null,
  "status": "queued",
  "conclusion": null,
  "error": null,
  "actor": "syntaqx",
  "created_at": "2026-10-04T15:42:07.318Z",
  "started_at": null,
  "finished_at": null
}

Errors

A failed request answers with one of these statuses and a body like {"error": {"code": "not_found", "message": "Repository not found."}}. See errors.

Status	Code	When
401	`unauthenticated`	A token is required, or the one sent is not valid.
403	`forbidden`	The token is valid but not allowed to do this, such as a member-only change or an agent token outside its repository.
404	`not_found`	It does not exist, or you cannot see it.
409	`conflict`	The request conflicts with the current state.
422	`invalid`	The input is not valid. `message` says which field and why.