v12

latestOpenAPI 3.0.3raw.githubusercontent.com2026-06-1811583196.1 KB
Virtual Machines

Add tag to VM

Attach a custom tag to a virtual machine. Tags help organize and filter resources. Returns the updated full tag list for the VM.

post/api/v1/vms/{id}/tags

Path parameters

idstring uuid required

VM ID (UUID)

Headers

X-Project-IDstring uuid required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Request body

namestring required

Tag name.

priorityinteger

Display priority (lower sorts first). Defaults to 0.

Example request

{
  "name": "production"
}

Response

Tag added

successboolean required

Example response

{
  "success": true
}