PATCH /orgs/{org}/actions/hosted-runners/{hosted_runner_id}
Updates a GitHub-hosted runner for an organization.
OAuth app tokens and personal access tokens (classic) need the manage_runners:org scope to use this endpoint.
Servers
- https://api.github.com
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
org |
String | Yes |
The organization name. The name is not case sensitive. |
hosted_runner_id |
Integer | Yes |
Unique identifier of the GitHub-hosted runner. |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
name |
String | No |
Name of the runner. Must be between 1 and 64 characters and may only contain upper and lowercase letters a-z, numbers 0-9, '.', '-', and '_'. |
runner_group_id |
Integer | No |
The existing runner group to add this runner to. |
maximum_runners |
Integer | No |
The maximum amount of runners to scale up to. Runners will not auto-scale above this number. Use this setting to limit your cost. |
enable_static_ip |
Boolean | No |
Whether this runner should be updated with a static public IP. Note limit on account. To list limits on account, use |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.