Delete Dataset API

API Information

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

Request Headers

Parameter	Type	Required	Description
Authorization	String	Yes	User authentication token
Content-Type	String	Yes	Must be set to application/json

Request Body Structure

Field	Type	Required	Description	Constraints
ids	List<Long>	Yes	Dataset ID list	Cannot be null

Request Body Example

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

Response Body Structure

CommonResponse Object

Field	Type	Description
code	Integer	Response status code
message	String	Response message
data	DeleteDatasetResp	Dataset deletion response

DeleteDatasetResp Structure

Field	Type	Description
success	Boolean	Deletion success status
notDeleteDatasets	List<Dataset>	Datasets that could not be deleted

Response Examples

Success Response

{
  "code": 200,
  "message": "success",
  "data": {
    "success": true,
    "notDeleteDatasets": []
  }
}

Failure Response

{
  "code": 404,
  "message": "Dataset not found",
  "data": {
    "success": false,
    "notDeleteDatasets": [
      {
        "id": 12345,
        "name": "Satellite Dataset"
      }
    ]
  }
}

Error Code Description

Error Code	Description
200	Success
400	Request parameter error
401	Unauthorized
404	Dataset not found
500	Server internal error

Usage Instructions

1. This API is used to delete one or more datasets
2. Dataset IDs must be provided in an array
3. User authentication is required
4. Only dataset owners can delete their datasets
5. Returns detailed deletion result including datasets that could not be deleted

Notes

• Dataset IDs are required and cannot be null
• Multiple datasets can be deleted in a single request
• Deletion may fail if the dataset contains metadata or files
• Failed deletions are reported in notDeleteDatasets field
• User authentication token must be included in request headers
• Request body must be valid JSON format