v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB
actions

Set custom labels for a self-hosted runner for a repository

Remove all previous custom labels and set the new custom labels for a specific self-hosted runner configured in a repository.

Authenticated users must have admin access to the repository to use this endpoint.

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint.

put/repos/{owner}/{repo}/actions/runners/{runner_id}/labels

Path parameters

ownerstring required

The account owner of the repository. The name is not case sensitive.

repostring required

The name of the repository without the .git extension. The name is not case sensitive.

runner_idinteger required

Unique identifier of the self-hosted runner.

Request body

labelsstring[] required

The names of the custom labels to set for the runner. You can pass an empty array to remove all custom labels.

Response

Response

total_countinteger required