2.23. 团队
创建、列出和管理机构的团队。
2.23.1. getOrganizationTeamPermissions
返回机构团队的存储库权限列表。
GET /api/v1/organization/{orgname}/team/{teamname}/permissions
授权:
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
团队名称 | 团队的名称 | 字符串 |
path |
OrgName | 机构名称 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.23.2. updateOrganizationTeamMember
向现有团队添加或邀请成员。
PUT /api/v1/organization/{orgname}/team/{teamname}/members/{membername}
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
团队名称 | 团队的名称 | 字符串 |
path |
memberName | 团队成员的用户名 | string |
path |
OrgName | 机构名称 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.23.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 |
团队名称 | 团队的名称 | 字符串 |
path |
memberName | 团队成员的用户名 | string |
path |
OrgName | 机构名称 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
204 | 已删除 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.23.4. getOrganizationTeamMembers
检索指定团队的成员列表。
GET /api/v1/organization/{orgname}/team/{teamname}/members
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
团队名称 | 团队的名称 | 字符串 |
path |
OrgName | 机构名称 | 字符串 |
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
includePending | 是否包含待处理的成员 | 布尔值 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.23.5. inviteTeamMemberEmail
邀请到现有团队的电子邮件地址。
PUT /api/v1/organization/{orgname}/team/{teamname}/invite/{email}
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要 电子邮件 | string | |
path |
团队名称 | 字符串 | |
path |
OrgName | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.23.6. deleteTeamMemberEmailInvite
删除一个邀请加入团队的电子邮件地址。
DELETE /api/v1/organization/{orgname}/team/{teamname}/invite/{email}
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要 电子邮件 | string | |
path |
团队名称 | 字符串 | |
path |
OrgName | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
204 | 已删除 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.23.7. updateOrganizationTeam
更新指定团队的机构范围权限。
PUT /api/v1/organization/{orgname}/team/{teamname}
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
团队名称 | 团队的名称 | 字符串 |
path |
OrgName | 机构名称 | 字符串 |
请求正文架构(application/json)
团队描述
名称 | 描述 | 模式 |
---|---|---|
需要 角色 | 机构应该应用到团队的权限 | 字符串 |
description | 团队的 Markdown 描述 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
200 | 成功调用 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |
2.23.8. deleteOrganizationTeam
删除指定的团队。
DELETE /api/v1/organization/{orgname}/team/{teamname}
授权: oauth2_implicit (org:admin)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
团队名称 | 团队的名称 | 字符串 |
path |
OrgName | 机构名称 | 字符串 |
响应
HTTP 代码 | 描述 | 模式 |
---|---|---|
204 | 已删除 | |
400 | 错误请求 | |
401 | 需要会话 | |
403 | 未授权访问 | |
404 | 未找到 |