API documentation

Manage your firm’s assets in bulk

Create resource groups, add up to 100 domains or applications in one request, and empty groups safely.

Create the group first

The key needs protection-resources:write. A restricted key cannot create a new group.

curl -X POST "https://api.darkradar.com/api/public/v1/protection-resources/groups" \
  -H "x-api-key: $DARKRADAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Üretim varlıkları","description":"Müşteriye açık sistemler"}'

Add resources in bulk

Each item is processed independently. already_exists means a duplicate was not created; limit_reached means the plan limit is full.

curl -X POST "https://api.darkradar.com/api/public/v1/protection-resources/bulk" \
  -H "x-api-key: $DARKRADAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resources":[{"groupId":"'$GROUP_ID'","resourceType":"domain","targetValue":"ornek.com.tr"},{"groupId":"'$GROUP_ID'","resourceType":"application","targetValue":"com.ornek.app"}]}'

Empty and delete the group

A group that still contains resources returns 409. Move resources with PUT /v1/protection-resources/{id} or bulk-delete them, then delete the group.

curl -X DELETE "https://api.darkradar.com/api/public/v1/protection-resources/bulk" \
  -H "x-api-key: $DARKRADAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids":["'$RESOURCE_ID'"]}'

curl -X DELETE "https://api.darkradar.com/api/public/v1/protection-resources/groups/$GROUP_ID" \
  -H "x-api-key: $DARKRADAR_API_KEY"
Records owned by another firm or outside a restricted key’s allowed groups appear as not_found; their existence is not disclosed.

Was this page helpful?