@@ -21,6 +21,12 @@ services to mark commits as passing or failing builds using Status. The
2121` description ` would be the high level summary of what happened with the
2222build.
2323
24+ Statuses can include a` context ` to indicate what service is providing that status.
25+ For example, you may have your continuous integration service push statuses with a context of` ci ` ,
26+ and a security audit tool push statuses with a context of` security ` . You can
27+ then use the[ combined status endpoint] ( https://developer.github.com/v3/repos/statuses/#get-the-combined-status-for-a-specific-ref )
28+ to retrieve the whole status for a commit.
29+
2430Note that the` repo:status ` [ OAuth scope] ( /v3/oauth/#scopes ) grants targeted
2531access to Statuses** without** also granting access to repository code, while the
2632` repo ` scope grants permission to code as well as statuses.
@@ -31,6 +37,9 @@ Users with push access can create commit statuses for a given ref:
3137
3238POST /repos/:owner/:repo/statuses/:sha
3339
40+ Note: there is a limit of 1000 statuses per` sha ` and` context ` within a Repository.
41+ Attempts to create more than 1000 statuses will result in a validation error.
42+
3443###Parameters
3544
3645Name | Type | Description