orgs

Closing down - Delete a custom role

[!WARNING] Closing down notice: This operation is closing down and will be removed after September 6, 2023. Use the "Delete a custom repository role" endpoint instead.

Deletes a custom role from an organization. Once the custom role has been deleted, any user, team, or invitation with the deleted custom role will be reassigned the inherited role. For more information about custom repository roles, see "About custom repository roles."

The authenticated user must be an administrator for the organization to use this endpoint.

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

delete/orgs/{org}/custom_roles/{role_id}

Request

  • Base URL: https://api.github.com
  • URL: https://api.github.com/orgs/{org}/custom_roles/{role_id}
  • Auth: none declared

Path parameters

orgstring required

The organization name. The name is not case sensitive.

role_idinteger required

The unique identifier of the role.

Response

Response

Changes

No recorded changes to this operation across all 83 revisions of this API.