ScanopyScanopy
Tags

Bulk remove a tag from multiple entities

Removes a single tag from multiple entities of the same type.

Validation

  • Entity type must be taggable (Host, Service, Subnet, Group, Network, Discovery, Daemon, DaemonApiKey, UserApiKey)
  • Entities that don't have the tag are silently skipped
POST
/api/v1/tags/assign/bulk-remove
Authorization<token>

User API key (Bearer scp_u_...). Create in Platform > API Keys.

In: header

Request Body

application/json

entity_ids*array<string>

The IDs of entities to modify

entity_type*string

The entity type (e.g., Host, Service, Subnet)

Value in"Organization" | "Invite" | "Share" | "Network" | "DaemonApiKey" | "UserApiKey" | "User" | "Tag" | "Discovery" | "Daemon" | "Host" | "Service" | "Port" | "Binding" | "Interface" | "Subnet" | "Group" | "Topology" | "Unknown"
tag_id*string

The tag ID to add or remove

Formatuuid

Response Body

application/json

application/json

curl -X POST "https://loading/api/v1/tags/assign/bulk-remove" \  -H "Content-Type: application/json" \  -d '{    "entity_ids": [      "497f6eca-6276-4993-bfeb-53cbbbba6f08"    ],    "entity_type": "Organization",    "tag_id": "39c8a0b3-fbe8-4801-95bf-e8a0792edf1d"  }'
{
  "meta": {
    "api_version": 1,
    "server_version": "0.13.5"
  },
  "success": true,
  "data": {
    "affected_count": 0
  },
  "error": "string"
}
{
  "success": true,
  "error": "string"
}