Skip to content

Delete tags

Request

Delete one or more profile tags.

  • Preconditions: at least one id must resolve within the team; ids that do not are ignored silently.
  • Effect: deletes the tags. The tag disappears from every profile that carried it, and no profile is deleted. This endpoint only manages profile tags — Cloud Storage file tags are managed separately.
  • Completion: synchronous. A repeat call reports the tags as invalid, which means the first one succeeded.

Documented business errors: 19105. See Error Codes for what each code means. Any operation can additionally return the common codes.

Bodyapplication/jsonrequired
idsArray of stringsrequired

Unique ID of the tag to be updated

POST
/api/envtag/delete
curl -i -X POST \
  http://127.0.0.1:40000/api/envtag/delete \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": [
      "string"
    ]
  }'

Responses

Success. data is a single boolean value.

Headers
any
Bodyapplication/json
codeintegerrequired

Return result code 0:Normal Other codes are exceptions.

msgstring or nullrequired

Error message

databooleanrequired
requestIdstringrequired

Operation Request ID

Response
{ "code": 0, "msg": "", "data": true, "requestId": "" }