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

PUT

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

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.

リクエストパラメータ

パスパラメータ

リクエストボディパラメータapplication/json

例

レスポンス

🟢200OK

application/json

Response

ボディapplication/json

🟠404Record Not Found

🟠422Parameter Error

リクエストExample

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://service1.exmaple.com/repos///actions/runners//labels' \
--header 'Content-Type: application/json' \
--data '{
    "labels": [
        "gpu",
        "accelerated"
    ]
}'

レスポンスExample

200 - default

{
    "total_count": 4,
    "labels": [
        {
            "id": 5,
            "name": "self-hosted",
            "type": "read-only"
        },
        {
            "id": 7,
            "name": "X64",
            "type": "read-only"
        },
        {
            "id": 20,
            "name": "macOS",
            "type": "read-only"
        },
        {
            "id": 21,
            "name": "no-gpu",
            "type": "custom"
        }
    ]
}

更新日時 2025-06-12 06:47:19

Add custom labels to a self-hosted runner for a repository

Remove all custom labels from a self-hosted runner for a repository