Commit8009dff

committed

Merge pull requestgithub#91 from github/hook-scopes

Document new hooks scopes

2 parentsc71cfea +64e8a8f commit8009dffCopy full SHA for 8009dff

File tree

+25

-0

lines changed

+25

-0

lines changed

Lines changed: 22 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,22 @@`
	`1`	`+---`
	`2`	`+kind:change`
	`3`	`+title:New scopes for managing repository hooks`
	`4`	`+created_at:2014-02-10`
	`5`	`+author_name:pengwynn`
	`6`	`+---`
	`7`	`+`
	`8`	`+Many third party services need to set up[hooks][] in order to act upon events`
	`9`	`+in your repositories. Today, we've introduced three new[scopes][] that provide`
	`10`	`+more granular access to your repository hooks without allowing access to your`
	`11`	`+repository contents:`
	`12`	`+`
	`13`	+*`read:repo_hook` grants read access to hooks in public or private repositories.
	`14`	+*`write:repo_hook` grants read and write access to hooks in public or private repositories.
	`15`	+*`admin:repo_hook` grants read, write, and delete access to hooks in public or private repositories.
	`16`	`+`
	`17`	`+As always, if you have any questions or feedback,[get in touch][contact].`
	`18`	`+`
	`19`	`+[hooks]:http://developer.github.com/v3/repos/hooks/`
	`20`	`+[scopes]:http://developer.github.com/v3/oauth/#scopes`
	`21`	`+[contact]:https://github.com/contact?form%5Bsubject%5D=API+repo+hook+scopes`
	`22`	`+`

Lines changed: 3 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -171,6 +171,9 @@ Name \| Description`
`171`	`171`	`delete_repo`\| Grants access to delete adminable repositories.
`172`	`172`	`notifications`\| Grants read access to a user's notifications.`repo` also provides this access.
`173`	`173`	`gist`\| Grants write access to gists.
	`174`	+`read:repo_hook`\| Grants read access to hooks in public or private repositories.
	`175`	+`write:repo_hook`\| Grants read and write access to hooks in public or private repositories.
	`176`	+`admin:repo_hook`\| Grants read, write, and delete access to hooks in public or private repositories.
`174`	`177`
`175`	`178`	`NOTE: Your application can request the scopes in the initial redirection. You`
`176`	`179`	`can specify multiple scopes by separating them with a comma:`

Comments

(0)