How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

GitHub Orgs API

The Orgs API from GitHub — 30 operation(s) for orgs.

GitHub Orgs API is one of 350 APIs that GitHub publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Organization. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, and an API reference.

This API exposes 49 operations across 30 paths, and defines 31 schemas. It is described by OpenAPI 3.2.0, at version 1.1.4.

Requests are made against a single base URL, {protocol}://{hostname}/api/v3.

49 operations 30 paths 31 schemas 9 DELETE25 GET6 PATCH5 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.1.4
Base URL
https://api.github.com
Contact
License
Terms of Service
Resource Areas
1

Paths & Operations 49

Across 30 paths, the API surfaces 49 operations — 9 DELETE, 25 GET, 6 PATCH, 5 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

Orgs 49
GET
/organizations
GitHub List Organizations
orgs/list 2 params → 200304
GET
/organizations/{organization_id}/custom_rolesdeprecated
GitHub Deprecated - List Custom Repository Roles in an Organization
orgs/list-custom-roles 1 param → 200
GET
/orgs/{org}
GitHub Get an Organization
orgs/get 1 param → 200404
PATCH
/orgs/{org}
GitHub Update an Organization
orgs/update 1 param body → 200409422
DELETE
/orgs/{org}
GitHub Delete an Organization
orgs/delete 1 param → 202403404
GET
/orgs/{org}/announcement
GitHub Get Announcement Banner for Organization
announcement-banners/get-announcement-banner-for-org 1 param → 200
PATCH
/orgs/{org}/announcement
GitHub Set Announcement Banner for Organization
announcement-banners/set-announcement-banner-for-org 1 param body → 200
DELETE
/orgs/{org}/announcement
GitHub Remove Announcement Banner from Organization
announcement-banners/remove-announcement-banner-for-org 1 param → 204
GET
/orgs/{org}/audit-log
GitHub Get the Audit Log for an Organization
orgs/get-audit-log 8 params → 200
GET
/orgs/{org}/custom-repository-roles
GitHub List Custom Repository Roles in an Organization
orgs/list-custom-repo-roles 1 param → 200
POST
/orgs/{org}/custom-repository-roles
GitHub Create a Custom Repository Role
orgs/create-custom-repo-role 1 param body → 201404422
GET
/orgs/{org}/custom-repository-roles/{role_id}
GitHub Get a Custom Repository Role
orgs/get-custom-repo-role 2 params → 200404
PATCH
/orgs/{org}/custom-repository-roles/{role_id}
GitHub Update a Custom Repository Role
orgs/update-custom-repo-role 2 params body → 200404422
DELETE
/orgs/{org}/custom-repository-roles/{role_id}
GitHub Delete a Custom Repository Role
orgs/delete-custom-repo-role 2 params → 204
GET
/orgs/{org}/hooks
GitHub List Organization Webhooks
orgs/list-webhooks 3 params → 200404
POST
/orgs/{org}/hooks
GitHub Create an Organization Webhook
orgs/create-webhook 1 param body → 201404422
GET
/orgs/{org}/hooks/{hook_id}
GitHub Get an Organization Webhook
orgs/get-webhook 2 params → 200404
PATCH
/orgs/{org}/hooks/{hook_id}
GitHub Update an Organization Webhook
orgs/update-webhook 2 params body → 200404422
DELETE
/orgs/{org}/hooks/{hook_id}
GitHub Delete an Organization Webhook
orgs/delete-webhook 2 params → 204404
GET
/orgs/{org}/hooks/{hook_id}/config
GitHub Get a Webhook Configuration for an Organization
orgs/get-webhook-config-for-org 2 params → 200
PATCH
/orgs/{org}/hooks/{hook_id}/config
GitHub Update a Webhook Configuration for an Organization
orgs/update-webhook-config-for-org 2 params body → 200
GET
/orgs/{org}/hooks/{hook_id}/deliveries
GitHub List Deliveries for an Organization Webhook
orgs/list-webhook-deliveries 5 params → 200400422
GET
/orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}
GitHub Get a Webhook Delivery for an Organization Webhook
orgs/get-webhook-delivery 3 params → 200400422
POST
/orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}/attempts
GitHub Redeliver a Delivery for an Organization Webhook
orgs/redeliver-webhook-delivery 3 params → 202400422
POST
/orgs/{org}/hooks/{hook_id}/pings
GitHub Ping an Organization Webhook
orgs/ping-webhook 2 params → 204404
GET
/orgs/{org}/installations
GitHub List App Installations for an Organization
orgs/list-app-installations 3 params → 200
GET
/orgs/{org}/members
GitHub List Organization Members
orgs/list-members 5 params → 200422
GET
/orgs/{org}/members/{username}
GitHub Check Organization Membership for a User
orgs/check-membership-for-user 2 params → 204302404
DELETE
/orgs/{org}/members/{username}
GitHub Remove an Organization Member
orgs/remove-member 2 params → 204403
GET
/orgs/{org}/memberships/{username}
GitHub Get Organization Membership for a User
orgs/get-membership-for-user 2 params → 200403404
PUT
/orgs/{org}/memberships/{username}
GitHub Set Organization Membership for a User
orgs/set-membership-for-user 2 params body → 200403422
DELETE
/orgs/{org}/memberships/{username}
GitHub Remove Organization Membership for a User
orgs/remove-membership-for-user 2 params → 204403404
GET
/orgs/{org}/outside_collaborators
GitHub List Outside Collaborators for an Organization
orgs/list-outside-collaborators 4 params → 200
PUT
/orgs/{org}/outside_collaborators/{username}
GitHub Convert an Organization Member to Outside Collaborator
orgs/convert-member-to-outside-collaborator 2 params body → 202204403404
DELETE
/orgs/{org}/outside_collaborators/{username}
GitHub Remove Outside Collaborator from an Organization
orgs/remove-outside-collaborator 2 params → 204422
GET
/orgs/{org}/public_members
GitHub List Public Organization Members
orgs/list-public-members 3 params → 200
GET
/orgs/{org}/public_members/{username}
GitHub Check Public Organization Membership for a User
orgs/check-public-membership-for-user 2 params → 204404
PUT
/orgs/{org}/public_members/{username}
GitHub Set Public Organization Membership for the Authenticated User
orgs/set-public-membership-for-authenticated-user 2 params → 204403
DELETE
/orgs/{org}/public_members/{username}
GitHub Remove Public Organization Membership for the Authenticated User
orgs/remove-public-membership-for-authenticated-user 2 params → 204
GET
/orgs/{org}/repository-fine-grained-permissions
GitHub List Repository Fine-grained Permissions for an Organization
orgs/list-repo-fine-grained-permissions 1 param → 200
GET
/orgs/{org}/security-managers
GitHub List Security Manager Teams
orgs/list-security-manager-teams 1 param → 200
PUT
/orgs/{org}/security-managers/teams/{team_slug}
GitHub Add a Security Manager Team
orgs/add-security-manager-team 2 params → 204409
DELETE
/orgs/{org}/security-managers/teams/{team_slug}
GitHub Remove a Security Manager Team
orgs/remove-security-manager-team 2 params → 204
POST
/orgs/{org}/{security_product}/{enablement}
GitHub Enable or Disable a Security Feature for an Organization
orgs/enable-or-disable-security-product-on-all-org-repos 3 params → 204422
GET
/user/memberships/orgs
GitHub List Organization Memberships for the Authenticated User
orgs/list-memberships-for-authenticated-user 3 params → 200304401403422
GET
/user/memberships/orgs/{org}
GitHub Get an Organization Membership for the Authenticated User
orgs/get-membership-for-authenticated-user 1 param → 200403404
PATCH
/user/memberships/orgs/{org}
GitHub Update an Organization Membership for the Authenticated User
orgs/update-membership-for-authenticated-user 1 param body → 200403404422
GET
/user/orgs
GitHub List Organizations for the Authenticated User
orgs/list-for-authenticated-user 2 params → 200304401403
GET
/users/{username}/orgs
GitHub List Organizations for a User
orgs/list-for-user 3 params → 200

Schemas 31

The contract defines 31 schemas that model the data the API accepts and returns. The most detailed are organization-full (56 properties), app-permissions (45 properties), audit-log-event (43 properties), simple-user (21 properties). Each schema is shown below with its type and property counts.

audit-log-event
object
43 properties
organization-custom-repository-role
object
Custom repository roles created by organization owners
8 properties 7 required
org-hook
object
Org Hook
11 properties 10 required
webhook-config-url
string
The URL to which the payloads will be delivered.
nullable-simple-user
objectnull
A GitHub user.
21 properties 18 required
announcement-message
stringnull
The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see "[Basic writing and formatting syntax](https://docs…
organization-custom-repository-role-update-schema
object
4 properties
scim-error
object
Scim Error
6 properties
validation-error
object
Validation Error
3 properties 2 required
webhook-config-secret
string
If provided, the secret will be used as the key to generate the HMAC hex digest value for [delivery signature headers](https://docs.github.com/enterprise-serve…
organization-custom-repository-role-create-schema
object
4 properties 3 required
hook-delivery
object
Delivery made by a webhook.
14 properties 13 required
webhook-config
object
Configuration object of the webhook
4 properties
announcement-banner
object
Announcement at either the repository, organization, or enterprise level
3 properties 3 required
announcement
object
Enterprise global announcement
2 properties 1 required
announcement-expiration
stringnull
The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO8601) format: YYYY-MM-DDTHH:MM:SSZ. To set an an…
organization-simple
object
A GitHub organization.
12 properties 12 required
team-simple
object
Groups of organization members that gives permissions on specified repositories.
12 properties 10 required
webhook-config-insecure-ssl
repository-fine-grained-permission
object
A fine-grained permission that protects repository resources.
2 properties 2 required
installation
object
Installation
20 properties 17 required
validation-error-simple
object
Validation Error Simple
3 properties 2 required
announcement-user-dismissible
booleannull
Whether an announcement can be dismissed by the user.
webhook-config-content-type
string
The media type used to serialize the payloads. Supported values include json and form. The default is form.
simple-user
object
A GitHub user.
21 properties 18 required
basic-error
object
Basic Error
4 properties
organization-full
object
Organization Full
56 properties 23 required
hook-delivery-item
object
Delivery made by a webhook, without request and response information.
11 properties 11 required
org-membership
object
Org Membership
7 properties 6 required
enterprise
object
An enterprise on GitHub.
10 properties 8 required
app-permissions
object
The permissions granted to the user access token.
45 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

github-orgs-api-openapi.yml Raw ↑

Other APIs GitHub publishes across the network.

GitHub Events API
GitHub Feeds API
GitHub Gists API
GitHub Issues API
GitHub Licenses API
GitHub Markdown API
GitHub Meta API
GitHub Notifications API
GitHub Octocat API
GitHub Projects API
GitHub Repos API
GitHub Search API
Where this information came from

This is an independent, third-party profile of GitHub Orgs API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.