Skip to main content
DELETE
/
v1
/
asset
/
{asset_id}
/
labels
Delete labels of an asset
curl --request DELETE \
  --url https://api.projectdiscovery.io/v1/asset/{asset_id}/labels \
  --header 'X-API-Key: <api-key>'
{
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.projectdiscovery.io/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint removes ALL labels from an asset. If you want to remove specific labels while keeping others, use PATCH /v1/asset/{asset_id}/labels with update_type=delete instead.

​
Overview

Remove all labels from a specific asset. This endpoint provides a quick way to completely clear an asset’s labels, useful when:
  • Resetting asset categorization
  • Cleaning up before re-labeling
  • Removing assets from all label-based groups
  • Decommissioning or archiving assets

​
Quick Example

curl -X DELETE "https://api.projectdiscovery.io/v1/asset/123456/labels" \
  -H "X-Api-Key: YOUR_API_KEY"

​
Response

​
Success Response

{
  "message": "All labels removed successfully"
}

​
Error Responses

Asset Not Found: 
{
  "message": "Asset not found",
  "code": "NOT_FOUND"
}
Invalid Asset ID: 
{
  "message": "Invalid asset ID format",
  "code": "INVALID_ID"
}

​
Behavior

​
Complete Label Removal

This endpoint removes all labels from the asset: Before: 
{
  "id": 123456,
  "name": "https://example.com",
  "labels": ["production", "api", "critical", "monitored"]
}
Request: 
curl -X DELETE "https://api.projectdiscovery.io/v1/asset/123456/labels" \
  -H "X-Api-Key: YOUR_API_KEY"
After: 
{
  "id": 123456,
  "name": "https://example.com",
  "labels": []
}

Authorizations

​
X-API-Key
string
header
required

Headers

​
X-Team-Id
string

Retrieve the Team ID from: https://cloud.projectdiscovery.io/settings/team

Path Parameters

​
asset_id
integer<int64>
required

Response

Example response

​
message
string
required