Add tag to VM

curl --request POST \
  --url https://api.rafftechnologies.com/api/v1/vms/{id}/tags \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>' \
  --data '
{
  "name": "production",
  "priority": 0
}
'

{
  "success": true,
  "tags": [
    {
      "id": "<string>",
      "name": "<string>",
      "priority": 123,
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}

POST

api

vms

{id}

tags

Add tag to VM

curl --request POST \
  --url https://api.rafftechnologies.com/api/v1/vms/{id}/tags \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>' \
  --data '
{
  "name": "production",
  "priority": 0
}
'

{
  "success": true,
  "tags": [
    {
      "id": "<string>",
      "name": "<string>",
      "priority": 123,
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}

_{Updated May 8, 2026}

Authorizations

X-API-Key

string

header

required

API key for authentication. Each key is bound to a specific account.

Headers

X-Project-ID

string<uuid>

required

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

Path Parameters

string<uuid>

required

VM ID (UUID)

Body

application/json

name

string

required

Tag name.

Required string length: 1 - 64

Example:

"production"

priority

integer

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

Example:

0

Response

Tag added

Returns the full updated tag list for the VM.

success

boolean

required

Example:

true