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