v12

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

Update VM tag

Update a tag's name or priority on a specific VM. Returns the updated full tag list for the VM.

Finding the tag ID

Tags are returned in the tags array of GET /api/v1/vms/{id}. Each tag includes its id, name, priority, and created_at. Use the tag's id as tagId here.

patch/api/v1/vms/{id}/tags/{tagId}

Path parameters

idstring uuid required

VM ID (UUID)

tagIdstring uuid required

Tag ID (UUID). Get it from the tags array on GET /api/v1/vms/{id} — each tag has an id field.

Headers

X-Project-IDstring uuid required

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

Request body

namestring

New tag name.

priorityinteger

New display priority.

Response

Tag updated

successboolean required

Example response

{
  "success": true
}