8000 Merge pull request #826 from github/update-1437589324 · Ratts704/developer.github.com@c677264 · GitHub
[go: up one dir, main page]
Skip to content

Commit c677264

Browse files
hubothubot
committed
Merge pull request github#826 from github/update-1437589324
2 parents d927492 + acc3366 commit c677264

File tree

2 files changed

+21
-2
lines changed

2 files changed

+21
-2
lines changed

‎content/changes/2015-07-22-more-flexible-options-for-listing-repositories.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
kind: change
3+
title: More flexible options for listing repositories
4+
created_at: 2015-07-22
5+
author_name: jakeboxer
6+
---
7+
8+
The [List your repositories][list-your-repos] API now offers additional parameters to help you fetch the exact set of repositories you're looking for:
9+
10+
- The `visibility` parameter lets you request only your public repositories, only your private repositories, or both.
11+
- With the `affiliation` parameter, you can ask for repositories you own, repositories where you are a collaborator, repositories you have access to as an organization member, or any combination that suits your needs.
12+
13+
Use these new parameters separately, together, or in combination with other parameters to craft flexible queries that fetch the specific repositories you're seeking.
14+
15+
For full details, check out the [documentation][list-your-repos]. If you have any questions, please [get in touch][contact]!
16+
17+
[list-your-repos]: /v3/repos/#list-your-repositories
18+
[contact]: https://github.com/contact?form[subject]=List+your+repositories+API

‎content/v3/repos.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,11 +21,12 @@ authenticated user has access to through an organization membership.
2121

2222
Name | Type | Description
2323
-----|------|--------------
24-
`type`|`string` | Can be one of `all`, `owner`, `public`, `private`, `member`. Default: `all`
24+
`visibility` | `string` | Can be one of `all`, `public`, or `private`. Default: `all`
25+
`affiliation` | `string` | Comma-separated list of values. Can include:<br />* `owner`: Repositories that are owned by the authenticated user.<br />* `collaborator`: Repositories that the user has been added to as a collaborator.<br />* `organization_member`: Repositories that the user has access to through being a member of an organization. This includes every repository on every team that the user is on.<br /><br />Default: `owner,collaborator,organization_member`
26+
`type`|`string` | Can be one of `all`, `owner`, `public`, `private`, `member`. Default: `all`<br /><br />Will cause a `422` error if used in the same request as **visibility** or **affiliation**.
2527
`sort`|`string` | Can be one of `created`, `updated`, `pushed`, `full_name`. Default: `full_name`
2628
`direction`|`string` | Can be one of `asc` or `desc`. Default: when using `full_name`: `asc`; otherwise `desc`
2729

28-
2930
## List user repositories
3031

3132
List public repositories for the specified user.

0 commit comments

Comments
 (0)
0