Document *:org scopes

pengwynn · pengwynn · commit 24f9283ee734 · 2014-02-25T09:21:18.000-06:00
diff --git a/content/changes/2014-02-25-organization-oauth-scopes.md b/content/changes/2014-02-25-organization-oauth-scopes.md
@@ -0,0 +1,21 @@
+---
+kind: change
+title: OAuth scopes for organization and team resources
+created_at: 2014-02-25
+author_name: pengwynn
+---
+As a follow up to [the new scopes][yesterday] we announced yesterday, we've
+introduced even more OAuth scopes for working with organization and team
+resources:
+
+- `read:org` provides read-only access to organizations, teams, and membership.
+- `write:org` allows an application to update an organization and (un)publicize organization membership.
+- `admin:org` enables an application to fully manage organizations, teams, and memberships.
+
+Check out [the full list of OAuth scopes][scopes] supported by the API to
+ensure your application asks for only the permissions it needs. As always, if
+you have any questions or feedback, [get in touch][contact].
+
+[yesterday]: http://developer.github.com/changes/2014-02-24-finer-grained-scopes-for-ssh-keys/
+[scopes]: /v3/oauth/#scopes
+[contact]: https://github.com/contact?form[subject]=API+org+scopes
diff --git a/content/v3/oauth.md b/content/v3/oauth.md
@@ -183,6 +183,9 @@ Name | Description
 `read:repo_hook`| Grants read and ping access to hooks in public or private repositories.
 `write:repo_hook`| Grants read, write, and ping access to hooks in public or private repositories.
 `admin:repo_hook`| Grants read, write, ping, and delete access to hooks in public or private repositories.
+`read:org`| Read-only access to organization, teams, and membership.
+`write:org`| Write access to organization and (un)publicize organization membership.
+`admin:org`| Fully manage organization, teams, and memberships.
 `read:public_key`| List and view details for public keys.
 `write:public_key`| Create, list, and view details for public keys.
 `admin:public_key`| Fully manage public keys.
