2.22. 团队
创建、列出和管理机构的团队。
2.22.1. getOrganizationTeamPermissions
返回组织团队的存储库权限列表。
GET /api/v1/organization/{orgname}/team/{teamname}/permissions
授权:
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
teamName | 团队的名称 | 字符串 |
path |
OrgName | 机构的名称 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.22.2. updateOrganizationTeamMember
向现有团队添加或邀请成员。
PUT /api/v1/organization/{orgname}/team/{teamname}/members/{membername}
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
teamName | 团队的名称 | 字符串 |
path |
memberName | 团队成员的用户名 | 字符串 |
path |
OrgName | 机构的名称 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.22.3. deleteOrganizationTeamMember
删除团队成员。
If the user is merely invited to join the team, then the invite is removed instead.
DELETE /api/v1/organization/{orgname}/team/{teamname}/members/{membername}
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
teamName | 团队的名称 | 字符串 |
path |
memberName | 团队成员的用户名 | 字符串 |
path |
OrgName | 机构的名称 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
204 | 已删除 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.22.4. getOrganizationTeamMembers
检索指定团队的成员列表。
GET /api/v1/organization/{orgname}/team/{teamname}/members
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
teamName | 团队的名称 | 字符串 |
path |
OrgName | 机构的名称 | 字符串 |
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
includePending | 是否包含待处理的成员 | 布尔值 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.22.5. inviteTeamMemberEmail
向现有团队邀请电子邮件地址。
PUT /api/v1/organization/{orgname}/team/{teamname}/invite/{email}
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要 电子邮件 | 字符串 | |
path |
teamName | 字符串 | |
path |
OrgName | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.22.6. deleteTeamMemberEmailInvite
删除电子邮件地址的邀请以加入团队。
DELETE /api/v1/organization/{orgname}/team/{teamname}/invite/{email}
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要 电子邮件 | 字符串 | |
path |
teamName | 字符串 | |
path |
OrgName | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
204 | 已删除 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.22.7. updateOrganizationTeam
为指定团队更新机构范围权限。
PUT /api/v1/organization/{orgname}/team/{teamname}
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
teamName | 团队的名称 | 字符串 |
path |
OrgName | 机构的名称 | 字符串 |
请求正文模式(application/json)
团队的描述
名称 | 描述 | 模式 |
---|---|---|
角色 | 应用到团队的机构范围内的权限 | 字符串 |
description | 团队的 Markdown 描述 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.22.8. deleteOrganizationTeam
删除指定的团队。
DELETE /api/v1/organization/{orgname}/team/{teamname}
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
teamName | 团队的名称 | 字符串 |
path |
OrgName | 机构的名称 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
204 | 已删除 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |