[2fa-blog]:https://github.com/blog/1614-two-factor-authentication

{{#not-enterprise}}

<divclass="alert">

<p>

</p>

</div>

{{/not-enterprise}}

<%= headers 200,:pagination => default_pagination_rels %>

`privacy`|`string`| The level of privacy this team should have. Can be one of:<br/> *`secret` - only visible to organization owners and members of this team.<br/> *`closed` - visible to all members of this organization.<br/>Default:`secret`<br/>**This parameter requires a custom media type to be specified. Please see more in the alert below.**

`permission`|`string` |**Deprecated**. In the preview period described in the alert below, a team's`permission` attribute no longer dictates what permission it has on its repositories; it only dictates what permission the repositories in this request will be added with, and what permission a new repository will be added to the team with if none is specified by the user. Avoid confusion by specifying a`permission` when using the[Add team repository](/v3/orgs/teams/#add-team-repo) API instead.<br/><br/>The permission to grant the team. Can be one of:<br/> *`pull` - team members can pull, but not push to or administer these repositories.<br/> *`push` - team members can pull and push, but not administer these repositories.<br/> *`admin` - team members can pull, push and administer these repositories.<br/>Default:`pull`

{{#not-enterprise}}

<divclass="alert">

<p>

</p>

</div>

{{/not-enterprise}}

<%= json\

`privacy`|`string`| The level of privacy this team should have. Can be one of:<br/> *`secret` - only visible to organization owners and members of this team.<br/> *`closed` - visible to all members of this organization.<br/>Default:`secret`<br/>**This parameter requires a custom media type to be specified. Please see more in the alert below.**

`permission`|`string` |**Deprecated**. In the preview period described in the alert below, a team's`permission` attribute no longer dictates what permission it has on its repositories; it only dictates what permission a new repository will be added to the team with if none is specified by the user. Avoid confusion by specifying a`permission` when using the[Add team repository](/v3/orgs/teams/#add-team-repo) API instead.<br/><br/>The permission to grant the team. Can be one of:<br/> *`pull` - team members can pull, but not push to or administer these repositories.<br/> *`push` - team members can pull and push, but not administer these repositories.<br/> *`admin` - team members can pull, push and administer these repositories. Default:`pull`

{{#not-enterprise}}

<divclass="alert">

<p>

</p>

</div>

{{/not-enterprise}}

<%= json\

-----|------|--------------

`role`|`string`| Filters members returned by their role in the team. Can be one of:<br/> *`member` - normal members of the team.<br/> *`maintainer` - team maintainers.<br/> *`all` - all members of the team.<br/>Default:`all`<br/>**This parameter requires a custom media type to be specified. Please see more in the alert below.**

{{#not-enterprise}}

<divclass="alert">

<p>

</p>

</div>

{{/not-enterprise}}

<%= headers 200,:pagination => default_pagination_rels %>

-----|------|--------------

`role`|`string`| The role that this user should have in the team. Can be one of:<br/> *`member` - a normal member of the team.<br/> *`maintainer` - a team maintainer. Able to add/remove other team members, promote other team members to team maintainer, and edit the team's name and description.<br/>Default:`member`<br/>**This parameter requires a custom media type to be specified. Please see more in the alert below.**

{{#not-enterprise}}

<divclass="alert">

<p>

</p>

</div>

{{/not-enterprise}}

<%= headers 200 %>

{{#not-enterprise}}

<divclass="alert">

<p>

{{/not-enterprise}}

<%= headers 200 %>

<%= json:repo %>

<%= fetch_content(:optional_put_content_length) %>

{{#not-enterprise}}

<divclass="alert">

<p>

</p>

</div>

{{/not-enterprise}}

<%= headers 204 %>

{{#not-enterprise}}

<divclass="alert">

<p>

</p>

</div>

{{/not-enterprise}}

<%= headers 200,:pagination => default_pagination_rels %>

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

<%= fetch_content(:optional_put_content_length) %>

{{#not-enterprise}}

<divclass="alert">

<p>

</p>

</div>

{{/not-enterprise}}

<%= headers 204 %>