---
title: "Get self-hosted runners settings for an organization"
method: GET
path: "/orgs/{org}/actions/permissions/self-hosted-runners"
tags: ["actions"]
---

# Get self-hosted runners settings for an organization

`GET /orgs/{org}/actions/permissions/self-hosted-runners`

Gets the settings for self-hosted runners for an organization.

OAuth app tokens and personal access tokens (classic) need the `admin:org` scope or the "Actions policies" fine-grained permission to use this endpoint.

## Path parameters

- `org` string, required

## Response `200`

Response

- SelfHostedRunnersSettings
  - `enabled_repositories` 'all' | 'selected' | 'none', required — The policy that controls whether self-hosted runners can be used by repositories in the organization
  - `selected_repositories_url` string — The URL to the endpoint for managing selected repositories for self-hosted runners in the organization

## Other responses

- `403` — Forbidden
- `404` — Resource not found

---

[API](https://skmtc.net/github/apis/github-v3-rest-api-3.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-3/versions/dc0584ac4e13/schema)