---
title: "List custom repository roles in an organization"
method: GET
path: "/organizations/{organization_id}/custom_roles"
tags: ["orgs"]
deprecated: true
---

# List custom repository roles in an organization

`GET /organizations/{organization_id}/custom_roles`

> **Deprecated.**

List the custom repository roles available in this organization. In order to see custom
repository roles in an organization, the authenticated user must be an organization owner.

To use this endpoint the authenticated user must be an administrator for the organization or of an repository of the organization and must use an access token with `admin:org repo` scope.
GitHub Apps must have the `organization_custom_roles:read` organization permission to use this endpoint.

For more information on custom repository roles, see "[About custom repository roles](https://docs.github.com/enterprise-server@3.7/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-repository-roles)."

## Path parameters

- `organization_id` string, required

## Response `200`

Response - list of custom role names

- object
  - `total_count` integer — The number of custom roles in this organization
  - `custom_roles` OrganizationCustomRepositoryRole[]
    - `id` integer, required — The unique identifier of the custom role.
    - `name` string, required — The name of the custom role.

---

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