PATCH/api/v1/orgs/:orgId/teams/:teamId更新团队

Try it 面板需要启用 JavaScript。

更新团队名称；需要团队管理权限。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`
Content-Type	string	Yes	请求体内容类型（默认值 "application/json"）

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
  /** 请求体内容类型，默认值 "application/json" */
  Content-Type: string
}

{
  "Authorization": "Bearer st_7c1f9e05b28d4a63",
  "Content-Type": "application/json"
}

URL Parameters

Name	Data Type	Description
orgId	string	组织 ID
teamId	string	团队 ID

Body

Name	Data Type	Required	Description
name	string	Yes	团队名称

type RequestBody = {
  /** 团队名称 */
  name: string
}

{
  "name": "平台与工具组"
}

Response

Body

TeamDTO

Name	Data Type	Required	Description
teamId	string	Yes	团队 ID
orgId	string	Yes	所属组织 ID
name	string	Yes	团队名称
memberCount	number	Yes	团队成员数
createdAt	string	Yes	创建时间

type TeamDTO = {
  /** 团队 ID */
  teamId: string
  /** 所属组织 ID */
  orgId: string
  /** 团队名称 */
  name: string
  /** 团队成员数 */
  memberCount: number
  /** 创建时间 */
  createdAt: string
}

{
  "teamId": "01JD8SRS4N7W1Y9AT8X2AGN5B0N",
  "orgId": "01JD8SRP1N4T8W6XQ5V9XDL2Y7K",
  "name": "平台组",
  "memberCount": 4,
  "createdAt": "2026-09-02T03:00:00Z"
}

HTTP Code

HTTP Status	Meaning	Notes
200	成功	返回更新后的团队
403	无权操作	需要团队管理权限

Response Code

响应使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	返回更新后的团队
2501	无权操作组织	当前用户不持有团队管理权限

Examples

PATCH /api/v1/orgs/01JD8SRP1N4T8W6XQ5V9XDL2Y7K/teams/01JD8SRS4N7W1Y9AT8X2AGN5B0N
Authorization: Bearer st_7c1f9e05b28d4a63
Content-Type: application/json

{
  "name": "平台与工具组"
}

{
  "id": "01JD8SS6MZ1K5M3OH",
  "code": 0,
  "messages": [],
  "result": {
    "teamId": "01JD8SRS4N7W1Y9AT8X2AGN5B0N",
    "orgId": "01JD8SRP1N4T8W6XQ5V9XDL2Y7K",
    "name": "平台与工具组",
    "memberCount": 4,
    "createdAt": "2026-09-02T03:00:00Z"
  }
}