GitHub:Developer API
Developers
Blog
Support
Search

API
Reference
Webhooks
Guides
Libraries

Organizations
i.List your organizations
ii.List all organizations
iii.List user organizations
iv.Get an organization
v.Edit an organization

List your organizations

List organizations for the authenticated user.

OAuth scope requirements

This only lists organizations that your authorization allows you to operate on in some way (e.g., you can list teams with read:org scope, you can publicize your organization membership with user scope, etc.). Therefore, this API requires at least user or read:org scope. OAuth requests with insufficient scope receive a 403 Forbidden response.
GET /user/orgs

Response
Status: 200 OK
Link: ; rel=”next”,
; rel=”last”
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
[
{
“login”: “github”,
“id”: 1,
“url”: “https://api.github.com/orgs/github”,
“avatar_url”: “https://github.com/images/error/octocat_happy.gif”,
“description”: “A great organization”
}
]

List all organizations

Lists all organizations, in the order that they were created on GitHub.

Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of organizations.
GET /organizations

Parameters

Name

Type

Description

since string The integer ID of the last Organization that you’ve seen.

Response
Status: 200 OK
Link: ; rel=”next”
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
[
{
“login”: “github”,
“id”: 1,
“url”: “https://api.github.com/orgs/github”,
“avatar_url”: “https://github.com/images/error/octocat_happy.gif”,
“description”: “A great organization”
}
]

List user organizations

List public organization memberships for the specified user.

This method only lists public memberships, regardless of authentication. If you need to fetch all of the organization memberships (public and private) for the authenticated user, use the List your organizations API instead.
GET /users/:username/orgs

Response
Status: 200 OK
Link: ; rel=”next”,
; rel=”last”
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
[
{
“login”: “github”,
“id”: 1,
“url”: “https://api.github.com/orgs/github”,
“avatar_url”: “https://github.com/images/error/octocat_happy.gif”,
“description”: “A great organization”
}
]

Get an organization
GET /orgs/:org

Response
Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
“login”: “github”,
“id”: 1,
“url”: “https://api.github.com/orgs/github”,
“avatar_url”: “https://github.com/images/error/octocat_happy.gif”,
“description”: “A great organization”,
“name”: “github”,
“company”: “GitHub”,
“blog”: “https://github.com/blog”,
“location”: “San Francisco”,
“email”: “octocat@github.com”,
“public_repos”: 2,
“public_gists”: 1,
“followers”: 20,
“following”: 0,
“html_url”: “https://github.com/octocat”,
“created_at”: “2008-01-14T04:33:35Z”,
“type”: “Organization”
}

Edit an organization
PATCH /orgs/:org

Input

Name

Type

Description

billing_email string Billing email address. This address is not publicized.
company string The company name.
email string The publicly visible email address.
location string The location.
name string The shorthand name of the company.
description string The description of the company.

Example
{
“billing_email”: “support@github.com”,
“blog”: “https://github.com/blog”,
“company”: “GitHub”,
“email”: “support@github.com”,
“location”: “San Francisco”,
“name”: “github”,
“description”: “GitHub, the company.”
}

Response
Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
“login”: “github”,
“id”: 1,
“url”: “https://api.github.com/orgs/github”,
“avatar_url”: “https://github.com/images/error/octocat_happy.gif”,
“description”: “A great organization”,
“name”: “github”,
“company”: “GitHub”,
“blog”: “https://github.com/blog”,
“location”: “San Francisco”,
“email”: “octocat@github.com”,
“public_repos”: 2,
“public_gists”: 1,
“followers”: 20,
“following”: 0,
“html_url”: “https://github.com/octocat”,
“created_at”: “2008-01-14T04:33:35Z”,
“type”: “Organization”,
“total_private_repos”: 100,
“owned_private_repos”: 100,
“private_gists”: 81,
“disk_usage”: 10000,
“collaborators”: 8,
“billing_email”: “support@github.com”,
“plan”: {
“name”: “Medium”,
“space”: 400,
“private_repos”: 20
}
}

Overview

Activity

Gists

Git Data

Issues

Miscellaneous

Organizations

Members

Teams

Webhooks

Pull Requests

Repositories

Search

Users

Enterprise 2.2

This website is a public GitHub repository. Please help us by forking the project and adding to it.

API Status: good

Terms
Privacy
Security
Contact
 Status
Training
Shop
Blog
About

Design © 2015 Copyright 2015 GitHub, Inc.

ronaldjameslowry

GitHub:Developer API
Developers
Blog
Support
Search

API
Reference
Webhooks
Guides
Libraries

Organizations
i.List your organizations
ii.List all organizations
iii.List user organizations
iv.Get an organization
v.Edit an organization

List your organizations

List organizations for the authenticated user.

OAuth scope requirements

This only lists organizations that your authorization allows you to operate on in some way (e.g., you can list teams with read:org scope, you can publicize your organization membership with user scope, etc.). Therefore, this API requires at least user or read:org scope. OAuth requests with insufficient scope receive a 403 Forbidden response.
GET /user/orgs

Response
Status: 200 OK
Link: <https://api.github.com/resource?page=2&gt;; rel=”next”,
<https://api.github.com/resource?page=5&gt;; rel=”last”
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
[
{
“login”: “github”,
“id”: 1,
“url”: “https://api.github.com/orgs/github”,
“avatar_url”: “https://github.com/images/error/octocat_happy.gif”,
“description”: “A great organization”
}
]

List all organizations

Lists all organizations, in the order that they were created on GitHub.

Note: Pagination is powered exclusively by the since parameter. Use the Link…

View original post 377 more words

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s