Resource Tags

Key/value tags attached to resources for organization, filtering, and cost allocation.

Resource base path: /restapi/resourcetags

Method	Path	Description
POST	/restapi/resourcetags/createTags	Create Tags
GET	/restapi/resourcetags/resourceTagsList	List Resource Tags
DELETE	/restapi/resourcetags/deleteResourceTag/{uuid}	Delete Resource Tag

note

apikey and secretkey are required HTTP headers on every request and are omitted from the parameter tables below. See Authentication.

---

Create Tags

Create Tags.

POST /restapi/resourcetags/createTags

Parameters

Parameter	In	Type	Required	Description
resourceType	query	string	✅ Yes	One of: UserVm, Volume, Snapshot, VMSnapshot, Network, PublicIpAddress, FirewallRule, LoadBalancer, PortForwardingRule, Vpc, StaticRoute, NetworkACL, Template, ISO.
zoneUuid	query	string	✅ Yes	UUID of the zone the resource belongs to.

Request body

Field	Type	Required	Description
value	string	No
resourceUuid	string	No
key	string	No

{
  "value": "string",
  "resourceUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "key": "string"
}

Example request

curl -X POST \
  "https://portal.your-domain.com/restapi/resourcetags/createTags?resourceType=VALUE&zoneUuid=a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "apikey: YOUR_API_KEY" \
  -H "secretkey: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "value": "string",
  "resourceUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "key": "string"
}'

Responses

Code	Description
200	Successful operation.
401	Invalid authentication credentials.
550	Permission denied.

{
  "kongCreateTagsResponse": [
    {
      "isActive": true,
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "value": "string",
      "resourceUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "key": "string",
      "resourceType": "string"
    }
  ],
  "count": 1
}

---

List Resource Tags

List Resource Tags.

GET /restapi/resourcetags/resourceTagsList

Parameters

Parameter	In	Type	Required	Description
uuid	query	string	No	UUID of the resource.
resourceUuid	query	string	No
resourceType	query	string	No	Same enum as Create Tags.

Example request

curl -X GET \
  "https://portal.your-domain.com/restapi/resourcetags/resourceTagsList" \
  -H "apikey: YOUR_API_KEY" \
  -H "secretkey: YOUR_SECRET_KEY"

Responses

Code	Description
200	Successful operation.
401	Invalid authentication credentials.
550	Permission denied.

{
  "kongCreateTagsResponse": [
    {
      "isActive": true,
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "value": "string",
      "resourceUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "key": "string",
      "resourceType": "string"
    }
  ],
  "count": 1
}

---

Delete Resource Tag

Delete Resource Tag.

DELETE /restapi/resourcetags/deleteResourceTag/{uuid}

Parameters

Parameter	In	Type	Required	Description
uuid	path	string	✅ Yes	UUID of the resource.

Example request

curl -X DELETE \
  "https://portal.your-domain.com/restapi/resourcetags/deleteResourceTag/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "apikey: YOUR_API_KEY" \
  -H "secretkey: YOUR_SECRET_KEY"

Responses

Code	Description
200	Successful operation.
401	Invalid authentication credentials.
550	Permission denied.

{
  "kongCreateTagsResponse": [
    {
      "isActive": true,
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "value": "string",
      "resourceUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "key": "string",
      "resourceType": "string"
    }
  ],
  "count": 1
}