Team Upsert

POST/team/upsert

Request

Header Params

Content-MD5

string

required

Example:

application/json

team_id

integer

Team ID

optional

team_name

string

Team Name

required

Team name must be unique within the account

reset_if_name_exist

boolean

Update by name

optional

If team ID is not provided but team name exists, when this value is true, the team with the same name will be updated, otherwise the update will be rejected with a duplicate name error

description

string

Team Description

required

person_ids

array[integer]

Member ID List

optional

At least one of email, phone, or ID list is required. When multiple exist, the system will merge them

emails

array[string]

Member Email List

optional

At least one of email, phone, or ID list is required. When multiple exist, the system will merge them. When an email is used by both owner and member, both will be invited to join the team

phones

array[string]

Member Phone List

optional

At least one of email, phone, or ID list is required. When multiple exist, the system will merge them. When an email is used by both owner and member, both will be invited to join the team

{
  "team_id": 0,
  "team_name": "string",
  "reset_if_name_exist": true,
  "description": "string",
  "person_ids": [
    0
  ],
  "emails": [
    "string"
  ],
  "phones": [
    "string"
  ]
}

Request samples

Responses

成功(200)

HTTP Code: 200

Content Type : JSONapplication/json

error

object (DutyError)

optional

code

enum<string>

Error code

required

Allowed values:

InvalidParameterInvalidContentTypeUnauthorizedAccessDeniedMethodNotAllowedRequestTooFrequentlyRequestVerifyRequiredDangerousOperationRequestLockedRouteNotFoundBalanceNotEnoughUndonedOrderExistResourceNotFoundInternalErrorReferenceExist

message

string

Error description

required

data

object

optional

team_id

integer

optional

Not configured

Last modified: 2 个月前