团队Upsert - Flashcat API

curl --location --request POST 'https://api.flashcat.cloud/team/upsert?app_key' \ --header 'Content-MD5: application/json' \ --header 'Content-Type: application/json' \ --data-raw '{ "team_id": 0, "team_name": "string", "reset_if_name_exist": true, "description": "string", "ref_id": "string", "person_ids": [ 0 ], "emails": [ "string" ], "phones": [ "string" ] }'

请求参数

Authorization

在 query 添加参数

app_key

示例：

app_key: ********************

Header 参数

Content-MD5

string

必需

示例值:

application/json

Body 参数application/json

team_id

integer

团队ID

可选

team_name

string

团队名称

必需

团队名称要求账户下唯一

reset_if_name_exist

boolean

是否按名称更新

可选

如果没有传入团队ID，但团队名称已经存在，此值为true时，将更新同名团队，否则拒绝更新，提示存在同名团队

description

string

团队描述

必需

ref_id

string

关联ID

可选

person_ids

array[integer]

成员ID列表

可选

邮件、手机和ID列表至少有一个，同时存在多个，系统会进行合并

emails

array[string]

成员邮件列表

可选

邮件、手机和ID列表至少有一个，同时存在多个，系统会进行合并。当邮件同时被主体和成员使用，将同时邀请二人加入团队

phones

array[string]

成员手机列表

可选

邮件、手机和ID列表至少有一个，同时存在多个，系统会进行合并。当邮件同时被主体和成员使用，将同时邀请二人加入团队

示例

返回响应

🟢200成功

application/json

Body

error

object (DutyError)

可选

code

enum<string>

错误码

必需

枚举值:

InvalidParameterInvalidContentTypeUnauthorizedAccessDeniedMethodNotAllowedRequestTooFrequentlyRequestVerifyRequiredDangerousOperationRequestLockedRouteNotFoundBalanceNotEnoughUndonedOrderExistResourceNotFoundInternalErrorReferenceExist

message

string

错误描述

必需

data

object

可选

team_id

integer

可选