Skip to content

Delete Tag API ​

API Information ​

  • Request Path: /tag/delete/tag
  • Request Method: POST
  • Content-Type: application/json

Request Headers ​

ParameterTypeRequiredDescription
AuthorizationStringYesUser authentication token
Content-TypeStringYesMust be set to application/json

Request Body Structure ​

DeleteTagReq Object ​

FieldTypeRequiredDescriptionConstraints
idsList<Long>YesTag ID listMust contain valid tag IDs

Request Body Example ​

json
{
  "ids": [12345, 12346, 12347]
}

Response Body Structure ​

CommonResponse Object ​

FieldTypeDescription
codeIntegerResponse status code
messageStringResponse message
dataBooleanDeletion result, true indicates success

Response Examples ​

Success Response ​

json
{
  "code": 200,
  "message": "success",
  "data": true
}

Failure Response ​

json
{
  "code": 404,
  "message": "Tag not found",
  "data": false
}

Error Code Description ​

Error CodeDescription
200Success
400Request parameter error
401Unauthorized
404Tag not found
500Server internal error

Usage Instructions ​

  1. This API is used to delete a tag
  2. User authentication is required
  3. Tag ID must be provided
  4. Returns boolean indicating deletion success

Notes ​

  • Tag ID list is required and cannot be empty
  • Deletion may fail if the tag is in use by datasets or metadata
  • Multiple tags can be deleted in a single request
  • User authentication token must be included in request headers