ScanopyScanopy
Tags

Set all tags for an entity

Replaces all tags on an entity with the provided list.

Validation

  • Entity type must be taggable (Host, Service, Subnet, Group, Network, Discovery, Daemon, DaemonApiKey, UserApiKey)
  • All tags must exist and belong to your organization
PUT
/api/v1/tags/assign
Authorization<token>

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

In: header

Request Body

application/json

entity_id*string

The entity ID

Formatuuid
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_ids*array<string>

The new list of tag IDs

Response Body

application/json

application/json

application/json

curl -X PUT "https://loading/api/v1/tags/assign" \  -H "Content-Type: application/json" \  -d '{    "entity_id": "8161163a-f227-466f-bc01-090a01e80165",    "entity_type": "Organization",    "tag_ids": [      "497f6eca-6276-4993-bfeb-53cbbbba6f08"    ]  }'
{
  "meta": {
    "api_version": 1,
    "server_version": "0.13.5"
  },
  "success": true,
  "data": {},
  "error": "string"
}
{
  "success": true,
  "error": "string"
}
{
  "success": true,
  "error": "string"
}