kind:change

title:Organization Members Resource Changes

created_at:2012-10-12

author_name:pezra

Requesting the[member list](/v3/orgs/members/index.html#members-list) of an organization of which you are not a member now redirects to the[public members list](v3/orgs/members/index.html#public-members-list). Requests to[membership check](/v3/orgs/members/index.html#check-membership) resources of an organization of which you are not a member are similarly redirected to the equivalent[public membership check](/v3/orgs/members/index.html#check-public-membership) unless it is a check about yourself, in which case it is treated as a request by a member.

The changes where made to clarify the purpose of these various resources. The`/orgs/{org}/members` resources are intended for use by members of the organization in question. The`/orgs/{org}/public_members` resources are intended for acquiring information about organizations of which you are not a member.

can happen in resources that must have some unique key (such as Label

names).

If resources have custom validation errors, they will be documented with

the resource.

If resources have custom validation errors, they will be documented with the resource.

API v3 uses HTTP redirection where appropriate. Clients should assume that any request may result in a redirection. Receiving an HTTP redirection is*not* an error and clients should follow that redirect. Redirect responses will have a`Location` header field which contains the URI of the resource to which the client should repeat the requests.

301

: Permanent redirection. The URI you used to make the request has be superseded by the one specified in the`Location` header field. This and all future requests to this resource should be directed the new URI.

302, 307

: Temporary redirection. The request should be repeated verbatim to the URI specified in the`Location` header field but clients should continue to use the original URI for future requests.

Other redirection status codes may be used in accordance with the HTTP 1.1 spec.

Requests that return multiple items will be paginated to 30 items by

default. You can specify further pages with the`?page` parameter.For some

default. You can specify further pages with the`?page` parameter. For some

resources, you can also set a custom page size up to 100 with the`?per_page` parameter.

Note that for technical reasons not all endpoints respect the`?per_page` parameter,

see[events](http://developer.github.com/v3/events/) for example.

<%= json "Link" =>[

["url1", {:rel => "next"}],

["url2", {:rel => "foo",:bar => "baz"}]] %>

* TOC

{:toc}

List all users who are members of an organization. A member is a user

that belongs to at least 1 team in the organization. If the authenticated user is

also a member of this organization then both concealed and public

members will be returned. Otherwise only public members are returned.

that belongs to at least 1 team in the organization. If the authenticated user is also a member of this organization then both concealed and public members will be returned. If the reqeuster is not a member of the organization the query will be redirected to the[public members list](#public-members-list).

<%= headers 200 %>

<%= json(:user) { |h|[h] } %>

<%= headers 302, "Location" => "https://api.github.com/orgs/github/public_members" %>

Check if a user is, publicly or privately, a member of the organization.

<%= headers 204 %>

<%= headers 404 %>

<%= headers 404 %>

<%= headers 302,:Location => "https://api.github.com/orgs/github/public_members/pezra" %>

To add someone as a member to an org, you must add them to a

<%= headers 204 %>

Members of an organization can choose to have their membership

publicized or not.

<%= headers 200 %>

<%= json(:user) { |h|[h] } %>