As part of our ongoing efforts to improve flexibility and control for managing the security manager role, we are retiring the security manager API and replacing it with the more robust organization roles API, which provides expanded functionality for managing roles in an organization, including security managers.
Endpoints Affected
The following security manager endpoints will be retired in 12 months:
GET /orgs/{org}/security-managers/teams
PUT /orgs/{org}/security-managers/teams/{team_slug}
DELETE /orgs/{org}/security-managers/teams/{team_slug}
After this period, these endpoints will no longer be available. Instead, you can use the organization roles API to perform the same actions and much more.
Retirement Timeline
- GitHub.com: 2025-12-31
- GitHub Enterprise Server: Version 3.20
Replacements
The organization roles API offers enhanced capabilities for managing roles across an organization. Use the following endpoint as a replacement:
GET /orgs/{org}/roles
GET /orgs/{org}/roles/{role_id}/teams
PUT /orgs/{org}/roles/{role_id}/teams/{team_slug}
DELETE /orgs/{org}/roles/{role_id}/teams/{team_slug}
You can start transitioning to the organization roles API today on GitHub.com. For GitHub Enterprise Server users, the organization roles API will support the security manager role starting in version 3.16.
Learn more about the organization roles API and send us your feedback