You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Nov 1, 2017. It is now read-only.
Copy file name to clipboardExpand all lines: content/changes/2015-07-22-more-flexible-options-for-listing-repositories.md
+2-12Lines changed: 2 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,19 +7,9 @@ author_name: jakeboxer
7
7
8
8
We're offering an improved way to filter the repositories returned by the[List your repositories][list-your-repos] API. We've added two new parameters that supercede the old`type` parameter:`visibility` and`affiliation`.
9
9
10
-
The`visibility` parameter filters repositories by their visibility. It defaults to`"all"`, but youcanpass`"public"` or`"private"`toonly list public or privaterepositories(respectively).
10
+
The`visibility` parameter filters repositories by their visibility, while the`affiliation` parameter filters repositories by how they're affiliated with the authenticated user. Theycanbe used separately, together, and in combination with other parameterstocraft flexible queries that will fetch the exactrepositoriesyou're looking for.
11
11
12
-
The`affiliation` parameter filters repositories by how they're affiliated with the authenticated user. You can choose from three different affiliations:
13
-
14
-
- If you pass`"owner"`, you'll include repositories that are owned by the authenticated user.
15
-
- If you pass`"collaborator"`, you'll include repositories that the authenticated user has been added as a collaborator to.
16
-
- If you pass`"organization_member"`, you'll include repositories that the authenticated user has access to through an organization membership. For example, this will include all repositories that have been added to teams the authenticated user is on.
17
-
18
-
If you want to include repositories that span multiple types of affiliation, you can pass a comma-separated string. For example, if you want a list of all the repositories that the user owns or is a collaborator on, you can pass`affiliation=owner,collaborator`. If no`affiliation` parameter is passed, it defaults to`affiliation=owner,collaborator,organization_member`.
19
-
20
-
The`type` parameter will continue to function as normal, but if you'd like to learn how to take advantage of these new parameters, check out[the API documentation][list-your-repos].
21
-
22
-
If you have any questions or feedback, please[get in touch with us][contact]!
12
+
For full details, check out the[List your repositories API documentation][list-your-repos]. If you have any questions or feedback, please[get in touch with us][contact]!