Tags
Bulk add a tag to multiple entities
Adds a single tag to multiple entities of the same type. This is useful for batch tagging operations.
Validation
- Entity type must be taggable (Host, Service, Subnet, Group, Network, Discovery, Daemon, DaemonApiKey, UserApiKey)
- Tag must exist and belong to your organization
- Entities that already have the tag are silently skipped
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
Format
uuidResponse Body
application/json
application/json
application/json
curl -X POST "https://loading/api/v1/tags/assign/bulk-add" \ -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"
}{
"success": true,
"error": "string"
}