创建新团队或更新已有团队,更新时传入 team_id。
| 项目 | 说明 |
|---|---|
| 速率限制 | 每个账户 1,000 次/分钟;50 次/秒 |
| 权限要求 | 团队管理(organization) |
team_id(或置为 0)表示创建新团队;传入已有 ID 表示更新。team_name 须为 1–39 个字符且在账户内唯一。person_ids 可设置团队成员,会替换整个成员列表。emails 或 phones 可邀请尚未注册的成员。ref_id 是供第三方 HR 系统集成使用的外部标识。在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。
创建或更新团队的参数。
团队显示名称,1–39 个字符。
1 - 39团队 ID,省略或置为 0 表示创建新团队。
自定义描述。
500设置为团队成员的成员 ID 列表,会替换现有成员列表。
要邀请为成员的邮箱地址。
要邀请为成员的手机号码。
默认国家区号,用于 phones 中未采用 E.164 格式的手机号。
供 HR 系统集成使用的外部引用 ID。
若为 true,当同名团队已存在时重置其成员列表为传入的 person_ids。