Skip to main content
POST
/
api
/
v1
/
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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.rafftechnologies.com/llms.txt

Use this file to discover all available pages before exploring further.

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

id
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

tags
object[]
required
Last modified on May 8, 2026