---
title: "Remove a custom label from a self-hosted runner for a repository"
method: DELETE
path: "/repos/{owner}/{repo}/actions/runners/{runner_id}/labels/{name}"
tags: ["actions"]
---

# Remove a custom label from a self-hosted runner for a repository

`DELETE /repos/{owner}/{repo}/actions/runners/{runner_id}/labels/{name}`

Remove a custom label from a self-hosted runner configured
in a repository. Returns the remaining labels from the runner.

This endpoint returns a `404 Not Found` status if the custom label is not
present on the runner.

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.

## Path parameters

- `owner` string, required
- `repo` string, required
- `runner_id` integer, required
- `name` string, required

## Response `200`

Response

- object
  - `total_count` integer, required
  - `labels` RunnerLabel[], required
    - `id` integer — Unique identifier of the label.
    - `name` string, required — Name of the label.
    - `type` 'read-only' | 'custom' — The type of label. Read-only labels are applied automatically when the runner is configured.

## Other responses

- `404` — Resource not found
- `422` — Validation failed, or the endpoint has been spammed.

---

[API](https://skmtc.net/github/apis/api-github-com.md) · [All operations](https://skmtc.net/github/apis/api-github-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/api-github-com/revisions/312a80145102/schema)