跳转到主要内容
POST
/
team
/
upsert
团队Upsert
curl --request POST \
  --url 'https://api.flashcat.cloud/team/upsert?app_key=' \
  --header 'Content-MD5: <content-md5>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "team_name": "<string>",
  "description": "<string>",
  "team_id": 123,
  "reset_if_name_exist": true,
  "ref_id": "<string>",
  "person_ids": [
    123
  ],
  "emails": [
    "<string>"
  ],
  "phones": [
    "<string>"
  ]
}
'
{
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "data": {
    "team_id": 123
  }
}

授权

app_key
string
query
必填

请求头

Content-MD5
string
必填

请求体

application/json
team_name
string
必填

团队名称要求账户下唯一 

description
string
必填
team_id
integer
reset_if_name_exist
boolean

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

ref_id
string

关联ID

person_ids
integer[]

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

emails
string[]

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

phones
string[]

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

响应

200 - application/json
error
object

错误信息,仅失败时存在

data
object