Sync changes from upstream repository

Hubot · Hubot · commit 6cb475793f48 · 2015-06-17T15:51:33.000Z
diff --git a/content/changes/2015-06-17-organizations-endpoint.md b/content/changes/2015-06-17-organizations-endpoint.md
@@ -0,0 +1,31 @@
+---
+kind: change
+title: List all organizations
+created_at: 2015-06-17
+author_name: keavy
+---
+
+We've added a [new API method](/v3/orgs#list-all-organizations) to list all organizations:
+
+<pre class="terminal">
+$ curl https://api.github.com/organizations
+
+[
+  {
+    "login": "github",
+    "id": 9919,
+    "url": "https://api.github.com/orgs/github",
+    "repos_url": "https://api.github.com/orgs/github/repos",
+    "events_url": "https://api.github.com/orgs/github/events",
+    "members_url": "https://api.github.com/orgs/github/members{/member}",
+    "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+    "avatar_url": "https://avatars.githubusercontent.com/u/9919?v=3",
+    "description": "GitHub, the company."
+  },
+  ...
+]
+</pre>
+
+As always, if you have any questions or feedback, please [drop us a line][contact].
+
+[contact]: https://github.com/contact?form[subject]=API+-+Listing+Organizations
diff --git a/content/v3/orgs.md b/content/v3/orgs.md
@@ -35,6 +35,27 @@ With the new Organization Permissions API (described below), this method will on
 <%= headers 200, :pagination => default_pagination_rels %>
 <%= json(:org) { |h| [h] } %>
 
+## 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](/v3/#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
+
+<%= headers 200, :pagination => { :next => 'https://api.github.com/organizations?since=135' } %>
+<%= json(:org) {|h| [h] } %>
+
 ## List user organizations
 
 List [public organization memberships](https://help.github.com/articles/publicizing-or-concealing-organization-membership) for the specified user.
diff --git a/content/v3/users.md b/content/v3/users.md
@@ -69,8 +69,7 @@ Name | Type | Description
 
 ## Get all users
 
-This provides a dump of every user, in the order that they signed up for
-GitHub.
+Lists all users, in the order that they signed up on GitHub.
 
 Note: Pagination is powered exclusively by the `since` parameter.
 Use the [Link header](/v3/#link-header) to get the URL for the next page of
