# Re-run a workflow

From **GitHub v3 REST API**.

`POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun`

**Deprecated.**

Re-runs your workflow run using its `id`. You must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `actions:write` permission to use this endpoint.

## Parameters

### `owner`

- Location: path
- Required: true
- Type: `string`

### `repo`

- Location: path
- Required: true
- Type: `string`

### `run_id`

- Location: path
- Required: true
- Type: `integer`

The id of the workflow run.

## Responses

### `201`

Response

### `application/json`

- Type: `object`

```json
{"additionalProperties":false,"type":"object"}
```

## Request examples

### cURL

```shell
curl --request POST \
  --url {protocol}://{hostname}/api/v3/repos/{owner}/{repo}/actions/runs/{run_id}/rerun
```