_{Updated August 28, 2026}

API Changelog

All changes to the Raff public API. Current version: v1.0.0 (beta). 🟢 Added · 🔵 Updated · 🟡 Deprecated · 🔴 Removed · 🟣 Fixed

v1.0.0 (Beta)

August 28, 2026

Managed Databases — Plans

🔴 Removed — Sub-4 GiB ClickHouse and Kafka plans — GET /api/v1/database/plans no longer returns the 1 vCPU / 1 GiB, 1 vCPU / 2 GiB and 2 vCPU / 2 GiB tiers for clickhouse and kafka; both ladders now start at 2 vCPU / 4 GiB (ClickHouse $59.99/mo, Kafka$ 79.99/mo). Neither engine runs reliably below 4 GiB — ClickHouse’s own sizing guidance is that under 4 GB is not recommended, and a Kafka broker needs headroom for page cache on top of its heap. No existing instances were affected. Postgres, MySQL and Valkey ladders are unchanged and still start at $7.99

August 27, 2026

Kubernetes — API

🔵 Updated — Every kubeconfig now expires. GET /api/v1/k8s/clusters/{cluster_id}/kubeconfig returns a kubeconfig valid for 7 days by default (expires_in still selects 10 minutes–30 days); it no longer returns a permanent admin credential, which could never be revoked. Rotate access now invalidates every credential a customer holds
🟢 Added — Self-renewing kubeconfig in the CLI — raff kubernetes kubeconfig <cluster-id> writes a kubeconfig that carries no credential and fetches a short-lived token for each kubectl command. Nothing long-lived is stored on disk; --static keeps the old file-with-a-token shape for environments that cannot run the CLI
🟢 Added — Per-pool node plans — every node pool now has its own plan_id: create clusters with mixed pools (node_pools[].plan_id), and POST /clusters/{id}/pools accepts any plan — mix sizes and tiers (General Purpose / CPU-Optimized) in one cluster. Per-pool node_count minimum is now 1 (the cluster keeps ≥2 workers overall)
🟢 Added — CPU-Optimized worker plans — GET /api/v1/k8s/node-plans returns a node_class per plan (shared or cpu_optimized); CPU-Optimized nodes reserve far more host CPU per vCPU for compute-heavy workloads. Pick one via worker_plan_id as usual
🟢 Added — List cluster volumes — GET /api/v1/k8s/clusters/{cluster_id}/volumes returns the cluster’s PVC-provisioned persistent volumes (size, status, attached node, price); also shown on the cluster’s new Storage tab in the dashboard
🔵 Updated — Persistent volumes support online expansion: grow a PVC’s requested size and the disk and filesystem expand live (no pod restart); billing moves to the new size. Grow only, 10 GB–10 TB

August 26, 2026

Kubernetes — API

🟢 Added — Built-in persistent storage — every new cluster includes the raff-block default StorageClass: PersistentVolumeClaims are provisioned as Volumes, attached to the pod’s worker automatically, visible in your Volumes list, and billed at $0.08/GB/month (hourly) for exactly the GB claimed
🔴 Removed — Create cluster: storage_node_count and storage_node_disk_gb (dedicated Longhorn storage nodes) — any non-zero value is now rejected. Existing clusters with storage nodes keep working unchanged
🔵 Updated — Delete cluster now also deletes the cluster’s PVC-backed volumes, so no storage keeps billing after teardown

Kubernetes — Terraform

🟡 Deprecated — raff_k8s_cluster.storage_node_count / storage_node_disk_gb — leave unset; persistent storage is built in and billed per GB

August 25, 2026

Kubernetes — API

🟢 Added — Short-lived kubeconfigs — GET /api/v1/k8s/clusters/{id}/kubeconfig?expires_in=<seconds> issues a kubeconfig that expires on its own (10 minutes to 30 days)
🟢 Added — Rotate cluster access — POST /api/v1/k8s/clusters/{id}/kubeconfig/rotate invalidates every previously issued short-lived kubeconfig immediately
🔵 Updated — Create cluster: omitting version_id now converges the cluster to the platform-default version (previously it stayed on the base image version)

Kubernetes — CLI

🟢 Added — raff kubernetes kubeconfig --ttl <duration> (short-lived kubeconfig) and raff kubernetes kubeconfig rotate

Kubernetes — Terraform

🟢 Added — upgrade_mode, maintenance_day, maintenance_start on raff_k8s_cluster; changing version_id now performs a rolling in-place upgrade (the apply waits for completion) instead of destroying the cluster
🔵 Updated — Create cluster now works on subscription accounts — POST /api/v1/k8s/clusters validates the saved payment method, creates the monthly subscription, and charges it automatically (previously 402; same behavior as VM creation). Terraform and CLI creates work on subscription accounts as a result.
🔵 Updated — Scale node pool, Add node pool, Upgrade to HA now work on subscription clusters via the API — the pro-rated difference is charged to the saved payment method (balance first) and the monthly price is raised (previously 409). Dashboard flows still use checkout.

August 24, 2026

Kubernetes — API

🟢 Added — Version upgrades — GET /api/v1/k8s/clusters/{id}/upgrades (available targets, upgrade state, maintenance settings) and POST /api/v1/k8s/clusters/{id}/upgrade (in-place rolling upgrade: control-plane nodes one at a time, workers drained; free)
🟢 Added — Maintenance settings — PATCH /api/v1/k8s/clusters/{id}/maintenance: upgrade_mode (manual, auto_patch, auto_minor) and a weekly 4-hour maintenance window (maintenance_day, maintenance_start UTC)
🔵 Updated — node plans (ssd_gib) now state the actual 25 GB node root disk; worker plans are priced on vCPU/RAM, persistent storage is the storage-node product

Kubernetes — CLI

🟢 Added — raff kubernetes upgrade <cluster-id> — lists available upgrade targets, or starts a rolling in-place version upgrade with --version (--confirm-single-master on non-HA clusters)
🟢 Added — raff kubernetes maintenance <cluster-id> — set the upgrade mode (--mode manual|auto_patch|auto_minor) and the weekly 4-hour maintenance window (--day, --start UTC)
🟢 Added — raff kubernetes create --version <version-id> — create a cluster on a specific offered version; the cluster converges to it automatically after provisioning

August 23, 2026

Kubernetes — API

🟢 Added — Managed Kubernetes — full public API: clusters (GET/POST /api/v1/k8s/clusters, get/rename/delete, GET …/kubeconfig, POST …/ha), node pools (list/add/update/delete/scale), versions and node plans, nodes, events, metrics (including a 24h control-plane health summary), utilization stats, firewall, MetalLB pool and TCP forwards
🟢 Added — Idempotency-Key header on POST /api/v1/k8s/clusters — retries return the original cluster instead of provisioning twice
🟢 Added — pagination (limit, offset) on GET /api/v1/k8s/clusters; derived ready on clusters and actual_node_count on node pools
🔴 Removed — legacy POST /api/v1/k8s/clusters/{id}/scale (use the node-pool scale endpoint) and the internal vm_id field on node objects

August 20, 2026

Virtual Machines — API

🔵 Updated — Attach floating IP now supports multiple public IPv4s — POST /api/v1/vms/{id}/ip with ip_id accepts additional reserved IPv4s, up to 4 per VM. Auto-assign (type) is unchanged: available only while the VM has no public IP of that family.
🔵 Updated — List VM networks — GET /api/v1/vms/{id}/networks returns is_primary, marking the VM’s primary public IPv4 interface.
🔵 Updated — Detach floating IP — DELETE /api/v1/vms/{id}/ip/{nic_id}: detaching the primary IPv4 while other IPv4s remain promotes the lowest-numbered remaining IPv4 to primary. Clarified billing: reserved IPs keep billing until released; auto-assigned IPs are free and return to the shared pool.

July 28, 2026

Managed Databases — API

🟢 Added — Free tier for PostgreSQL, MySQL and Valkey — plans with is_free_tier: true in GET /api/v1/databases/plans cost $0 (one per account, fixed storage, no HA or replicas, daily backups with 3-day retention). Free databases pause after 7 idle days: status becomes suspended and all data is kept.
🟢 Added — Resume a paused database — POST /api/v1/databases/{id}/resume wakes a suspended database; it returns through deploying and reaches running in about a minute.
🔵 Updated — GET /api/v1/databases/plans returns max_connections (the client connection limit each plan enforces) and memory_mib (RAM for sub-GiB plans, e.g. free Valkey = 512). The database status enum gains suspended.

July 20, 2026

Managed Databases — API

🟢 Added — MySQL, ClickHouse, and Apache Kafka engines — the engine field on POST /api/v1/databases (and everywhere it appears) now accepts mysql, clickhouse, and kafka alongside postgres and valkey. Check live availability and versions with GET /api/v1/databases/engines.
🔵 Updated — engine is now a shared DatabaseEngine enum across all database endpoints and schemas; the engine catalog entry schema is named DatabaseEngineInfo. No wire-format change — request and response JSON are unchanged.
🔵 Updated — GET /api/v1/databases/{id}/connection returns ca_cert (PEM CA bundle) for engines with a private certificate authority — currently Kafka. Empty for other engines.

July 12, 2026

Virtual Machines — API

🔵 Updated — Backup schedules now report run state — GET /api/v1/backup-schedules and GET /api/v1/backup-schedules/{id} return enabled, next_run_at, last_run_at, last_run_status, and consecutive_failures. Use these to verify backups are running and alert on repeated failures. Existing fields are unchanged.
🔵 Updated — Minimum keep_count is now 2 on POST /api/v1/backup-schedules and PATCH /api/v1/backup-schedules/{id}. A retention of 1 does not work reliably with incremental backups. Existing schedules with keep_count: 1 keep working; the next update must set 2 or more.

July 8, 2026

Raff Apps — API

🟢 Added — Raff Apps (PaaS) — push-to-deploy app services on /api/v1/apps. Create web services, private services, workers, cron jobs, and one-off jobs; manage deployments (POST .../deployments), rollbacks (POST .../rollback), environment variables (.../env), custom domains (.../domains), scaling (.../scale), pause/resume, runtime and build logs, metrics, job runs, usage (GET /api/v1/apps/usage), and spend caps (.../spend-settings).
🟢 Added — List Apps tiers — GET /api/v1/apps/tiers and public GET /api/v1/public/pricing/apps. Compute sizes and prices; no authentication required.

Raff Apps — CLI

🟢 Added — raff apps command group: tiers, list, get, create, delete, deploy, rollback, scale, pause, resume, logs, deployments, env (list/set/delete), domains (list/add/delete), and usage.

Raff Apps — Terraform

🟢 Added — raff_app_service resource, plus raff_app_service, raff_app_services, and raff_app_tiers data sources.

July 6, 2026

Catalog — API

🟢 Added — List managed database pricing — GET /api/v1/public/pricing/database. Plans per engine (postgres, valkey) plus high availability, read replica, and extra storage pricing. Optional engine query filter.
🟢 Added — List managed Kubernetes pricing — GET /api/v1/public/pricing/kubernetes. Worker node plans plus HA control plane and NVMe storage node pricing.

May 25, 2026

Catalog — API

🟢 Added — out_of_stock field on VMPricingPlan — GET /api/v1/public/pricing/vm. Marks a plan as sold out. Informational only — the plan is still listed and can be ordered.

Catalog — CLI

🟢 Added — STOCK column on raff pricing vm, showing In Stock / Sold Out.

Catalog — Terraform

🟢 Added — out_of_stock attribute on data.raff_vm_pricing plans.

May 14, 2026

Virtual Machines — API

🔵 Updated — Backups now run as incremental backup series instead of one full image per call. Only changed blocks are stored after the first baseline, cutting storage and transfer dramatically. Existing backups taken before this change keep working unchanged — they restore identically to today.
🔵 Updated — storage_size on Backup is now MB (was GB). Incremental restore points are often a few MB; the previous integer-GB column rounded them up to 1 GB and overstated both display and billing. Existing rows have been backfilled (old_value_in_GB * 1024) so customer-visible amounts stay consistent. Clients should display in MB up to 1024, else convert to GB.
🟢 Added — increment_id field on Backup — GET /api/v1/backups. Position of a restore point within an incremental series; null for legacy standalone backups.
🟢 Added — Delete backup series — DELETE /api/v1/backups/{id}/chain. Removes every restore point in a series in one call. Use this when Delete backup reports that older points depend on the one being deleted.
🟢 Added — Reset backup series — POST /api/v1/vms/{id}/backups/reset-chain. Starts a fresh baseline on the next backup; existing restore points stay restorable.

May 10, 2026

Virtual Machines — API

🟢 Added — mac field on VMNetwork — GET /api/v1/vms/{id}/networks. Stable per-NIC MAC address. The backend already returned it; spec now documents it so generated clients expose it.

Volumes — API

🟣 Fixed — pricing_id now auto-derived from volume_type + region on POST /api/v1/volumes. The public spec never required customers to supply it, but the billing middleware did — every CLI/Terraform/curl request was returning 400 until you looked it up out-of-band.
🟣 Fixed — filesystem_type is now honored. A wire-mapping bug in vm-service was discarding the value and validating volume_type (e.g. nvme) as if it were a filesystem, rejecting all valid ext4 / xfs / "" combinations with “filesystem_type must be empty (manual), ext4, or xfs”.
🔵 Updated — pricing_id required-error now points at raff pricing vm (CLI) and data.raff_vm_pricing (Terraform) alongside the HTTP path.

Billing — API

🟣 Fixed — Add-payment-method (POST /api/v1/billing/payment-methods) now returns 503 if Airwallex’s payment-source linking step fails, instead of saving an unusable row that looked like a working primary card. Customers no longer end up with a dashboard-confirmed card that fails the first time the API tries to charge it.
🟣 Fixed — “Payment method not configured for automatic billing” error correctly identifies the affected row (filters by provider_type and non-empty source ID) instead of firing on any active payment row.
🔵 Updated — Error messages link to app.rafftechnologies.com regardless of environment (was hardcoded to a local-dev hostname).

Virtual Machines — CLI

🟢 Added — raff vm create --no-vpc — create a VM with only a public IP, no VPC at all. (raff-cli v0.3.5)
🟢 Added — MAC column on raff vm networks. (raff-cli v0.3.6)
🔵 Updated — raff vm create --help long help spells out all four networking modes (existing VPC / new VPC / no VPC / auto VPC). (raff-cli v0.3.4)
🔵 Updated — raff vm get shows base disk and attached volumes as separate rows (was a single collapsed “Storage” row). (raff-cli v0.3.4)
🔵 Updated — vm networks public-pool NICs show (public pool) instead of an empty NETWORK cell. (raff-cli v0.3.4)

Volumes — CLI

🔵 Updated — raff volume create --type help enumerates nvme (was a misleading “e.g. standard”). (raff-cli v0.3.3)
🔵 Updated — raff pricing volume table view shows the ID column. (raff-cli v0.3.3)

Networking — CLI

🔵 Updated — Security-group attachment count now labeled “Attached VMs” everywhere (was inconsistent — VMS in list, Attached NICs in get). (raff-cli v0.3.4)
🔴 Removed — Unexplained SIZE column from raff sg get rules subtable. (raff-cli v0.3.4)

Virtual Machines — Terraform

🟢 Added — data "raff_vm_networks" — list NICs for a VM with MAC, IP, gateway, and security-group binding. (terraform-provider-raff v0.1.8)
🟢 Added — skip_vpc argument on raff_vm. (terraform-provider-raff v0.1.7)
🔵 Updated — raff_vm schema descriptions for vpc_id / vpc_name / vpc_cidr / delete_vpc / volume_action rewritten to spell out the actual contract instead of one-liners. (terraform-provider-raff v0.1.6)
🔵 Updated — volume_type = "nvme" in README and Registry index examples (was an invalid "standard"). (terraform-provider-raff v0.1.4)

Networking — Terraform

🟢 Added — data "raff_vpc_cidr_suggestions" — fetch a non-overlapping CIDR for declarative VPC sizing. (terraform-provider-raff v0.1.9)
🟢 Added — data "raff_security_group_templates" — look up template IDs to pass to raff_security_group.template_id. (terraform-provider-raff v0.1.9)

Team & Access — Terraform

🟢 Added — data "raff_permissions" — read-only catalog of permission identifiers; supports scope filter (account / project). (terraform-provider-raff v0.1.9)

Reference — site

🔵 Updated — Terraform Registry sidebar collapsed from 7 noisy buckets to a single Virtual Machines subcategory. (terraform-provider-raff v0.1.5)

Catalog — CLI / Terraform

🟣 Fixed — category filter on raff template list (CLI v0.3.7) and data.raff_templates (terraform-provider-raff v0.1.10) — flag help, schema description, and README/Registry examples all incorrectly claimed values like linux / windows. The real enum is os (Linux/Windows OS templates) or marketplace (pre-baked apps); OS family (linux / windows / alpine / etc.) lives on the os_type response field with no API-level filter today.

Virtual Machines — Terraform

🟣 Fixed — raff_vm Create now waits for the VM to reach active before returning. Previously terraform apply returned as soon as the API accepted the request, so public_ipv4 / private_ipv4 were empty until the customer ran terraform refresh. Default timeout 15 minutes; override with timeouts { create = "20m" }. (terraform-provider-raff v0.1.11)
🔵 Updated — volume_action description on raff_vm rewritten to clarify it only governs volumes not under Terraform management (attached out-of-band via dashboard / CLI). Volumes managed by raff_volume in the same config are destroyed by Terraform independently. (terraform-provider-raff v0.1.11)

Compute — CLI

🟢 Added — raff volume list|get|create|delete|resize|attach|detach — documentation page for block storage volume commands.
🟢 Added — raff snapshot list|get|create|rename|restore|delete — documentation page for VM and volume snapshots.
🟢 Added — raff backup list|get|create|restore|delete and raff backup schedule list|get|create|update|delete — documentation page for backups and recurring schedules.

Networking — Terraform

🟢 Added — raff_vpc documentation page — VPC resource, CIDR immutability, gateway computed attrs.
🟢 Added — raff_ip documentation page — floating IP reservation.
🟢 Added — raff_security_group documentation page — firewall rulesets with nested rule blocks and template seeding.

Compute — Terraform

🟢 Added — raff_volume, raff_snapshot, raff_backup, raff_backup_schedule documentation pages — covering immutability rules, retention semantics, and the “don’t manage schedule-created backups” guidance.

Team & Access — CLI

🟢 Added — raff ssh-key, raff api-key, raff member, raff role, raff permission, raff invitation documentation pages — full coverage of IAM commands.
🟢 Added — raff project member subcommands documented under raff project — list, get, add, update, remove.

Team & Access — Terraform

🟢 Added — raff_ssh_key, raff_api_key, raff_role, raff_member, raff_project_member documentation pages — including the secret returned-once warning on raff_api_key and the composite ID format on raff_project_member.

Catalog — CLI / Terraform

🟢 Added — raff region, raff template, raff pricing (CLI) and a consolidated data-sources page (Terraform) covering raff_regions, raff_templates, and the *_pricing family.

Reference — site

🔵 Updated — Reference tab CLI and Terraform groups in docs.json reorganized to expose every command group and resource in the sidebar.
🔵 Updated — reference/cli/introduction.mdx and reference/terraform/introduction.mdx refreshed with the full surface — coverage table now lists every resource group instead of the original 5–7.

May 8, 2026

Volumes — API

🟢 Added — Volume CRUD + attach/detach — GET/POST /api/v1/volumes, GET/DELETE /api/v1/volumes/{id}, POST /api/v1/volumes/{id}/attach, POST /api/v1/volumes/{id}/detach. Create is async (202 Accepted).
🔴 Removed — vm_id, vm_internal_id, image_id, attached_volume_id fields from volume responses (OpenNebula internal identifiers). Use id and product_vm instead.

Snapshots — API

🟢 Added — Snapshot CRUD + restore + rename — GET/POST /api/v1/snapshots, GET/DELETE /api/v1/snapshots/{id}, POST /api/v1/snapshots/{id}/restore, PATCH /api/v1/snapshots/{id}/rename. Supports VM and volume sources (resource_type: vm|volume). Snapshot.status = active indicates the source has been reverted to this snapshot.

Backups — API

🟢 Added — Backup CRUD + restore — GET/POST /api/v1/backups, GET/DELETE /api/v1/backups/{id}, POST /api/v1/backups/{id}/restore. Create and restore are async (202 Accepted).
🟢 Added — Backup schedules — GET/POST /api/v1/backup-schedules, GET/PATCH/DELETE /api/v1/backup-schedules/{id}. Daily or weekly with configurable retention.
🔴 Removed — schedule_id, backup_id, vm_id from backup/schedule responses (OpenNebula internal identifiers). Use id and product_vm.

SSH Keys — API

🟢 Added — SSH key CRUD — GET/POST /api/v1/ssh-keys, GET/PUT/DELETE /api/v1/ssh-keys/{id}. Account-scoped (no X-Project-ID required).

Team & Access — API

🟢 Added — Account Members — GET/POST /api/v1/members, GET/PATCH/DELETE /api/v1/members/{id}. Email invite, direct add, or attach an API key as member.
🟢 Added — Project Members — GET/POST /api/v1/projects/{id}/members, GET/PATCH/DELETE /api/v1/projects/{id}/members/{member_id}.
🟢 Added — Roles — GET/POST /api/v1/roles, GET/PATCH/DELETE /api/v1/roles/{id}. Custom account- or project-scoped roles. System roles are read-only.
🟢 Added — Permissions catalog — GET /api/v1/permissions. Lists every permission string usable in role definitions. Requires a valid API key (no specific permission needed).
🟢 Added — API Keys — GET/POST /api/v1/api-keys, GET/PATCH/DELETE /api/v1/api-keys/{id}, POST /api/v1/api-keys/{id}/regenerate. Full secret only returned once at create or regenerate.
🟢 Added — Invitations — POST /api/v1/invitations (account), POST /api/v1/projects/{id}/invitations (project), DELETE /api/v1/invitations/{id} (cancel). Public spec deliberately omits Invitation.token since it’s the acceptance secret.

Cross-cutting — wire/spec alignment

🔴 Removed — vm_id from VM responses, vnet_id / vxlan_vni / router_vm_id from VPC responses, ip_group_id / subnet_id / vm_id from floating IP responses, network_id / mac / bridge / vxlan_vni from VM network interface responses, and the legacy top-level project_id / project_name from API key responses. All are OpenNebula internal identifiers that the public spec already hid; the gateway response now matches the spec.

April 30, 2026

Virtual Machines — API

🟢 Added — skip_public_ip and skip_vpc flags on Create VM — POST /api/v1/vms. Build VPC-only VMs (no public IP) or public-IP-only VMs (no VPC). Cannot be combined.

Networking — API

🟢 Added — Floating IP reserve/release — POST /api/v1/ips/reserve, DELETE /api/v1/ips/{id}/reserve, plus GET /api/v1/ips, GET /api/v1/ips/{id}, POST /api/v1/ips/{id}/change. Reserve runs through the same balance/billing checks as VM create (402 / 403). Release refunds remaining time pro-rata for subscription IPs.
🟢 Added — VPC CRUD — POST/GET/PUT/DELETE /api/v1/vpcs[/{id}] and GET /api/v1/vpcs/cidr-suggestions. Customers can now create and manage VPCs directly via the public API instead of only through VM creation.
🟢 Added — ?type=public|vpc|ipv6 query filter on List VM network interfaces — GET /api/v1/vms/{id}/networks?type=public.
🔵 Updated — VMNetwork.type enum now includes ipv6.
🔴 Removed — mac field from public VMNetwork schema (still in raw response for the dashboard, hidden from public API consumers).

Networking — CLI

🟢 Added — raff ip list|get|reserve|release|change
🟢 Added — raff vpc list|get|create|update|delete|cidr-suggestions
🟢 Added — raff vm networks <vm-id> --type public|vpc|ipv6 filter

Virtual Machines — API

🟢 Added — Update VM note — PATCH /api/v1/vms/{id}/notes/{type} — replaces existing note content; returns 404 if no note exists yet (use PUT to create).
🟢 Added — Append to VM note — POST /api/v1/vms/{id}/notes/{type}/append — concatenates new content onto the existing note (newline-separated), creates the note if missing.
🟢 Added — type query filter on Get VM notes — GET /api/v1/vms/{id}/notes?type=personal|account to fetch only one scope.

Virtual Machines — CLI

🟢 Added — raff vm notes update <vm-id> --type X --content Y (errors if note missing)
🟢 Added — raff vm notes append <vm-id> --type X --content Y
🟢 Added — raff vm notes get <vm-id> --type personal|account filter
🟢 Added — raff vm tags list <vm-id> to discover tag IDs

April 29, 2026

Virtual Machines — API

🟢 Added — Hard reboot VM for unresponsive instances — POST /api/v1/vms/{id}/reboot-hard
🟢 Added — Save VM disk as custom image — POST /api/v1/vms/{id}/save-image
🟢 Added — List VM network interfaces — GET /api/v1/vms/{id}/networks
🟢 Added — Attach/detach VM to/from VPC — POST/DELETE /api/v1/vms/{id}/vpc[/{nic_id}]
🟢 Added — Attach/detach floating IP — POST/DELETE /api/v1/vms/{id}/ip[/{nic_id}]
🟢 Added — Attach/detach security group to VM NIC — POST/DELETE /api/v1/vms/{id}/firewall[/{sg_id}/{nic_id}]
🟢 Added — Add/update/remove VM tags — POST/PATCH/DELETE /api/v1/vms/{id}/tags[/{tagId}]
🟢 Added — Get/upsert VM notes (personal + account scopes) — GET /api/v1/vms/{id}/notes, PUT /api/v1/vms/{id}/notes/{type}
🔴 Removed — vm_id field from VM responses (was an OpenNebula internal identifier — use id instead)
🔵 Updated — BillingError.reason enum trimmed to currently-returned values: banned, failed, no_billing_customer. Insufficient balance now consistently returns 402 with a plain Error body.

Virtual Machines — CLI

🟢 Added — raff vm hard-reboot, raff vm save-image, raff vm networks, raff vm vpc attach|detach, raff vm ip attach|detach, raff vm sg attach|detach, raff vm tags add|update|remove, raff vm notes get|set

Virtual Machines — Terraform

🔴 Removed — vm_id computed attribute from raff_vm (was the OpenNebula int ID; use id instead)

March 25, 2026

General

🟢 Added — Changelog tracking started

March 15, 2026

Virtual Machines — API

🟢 Added — Resize VM disk storage without recreating — POST /api/v1/vms/{id}/disk/resize
🟢 Added — Bulk delete VMs in a single request — DELETE /api/v1/vms/bulk
🔵 Updated — Create VM now accepts enable_ipv6 parameter for IPv6 support — POST /api/v1/vms

March 10, 2026

Virtual Machines — API

🟢 Added — Reinstall OS on a running VM, keep your IP — POST /api/v1/vms/{id}/reinstall
🟢 Added — Factory reset VM to original state — POST /api/v1/vms/{id}/factory-reset
🟢 Added — Reset root password via API — POST /api/v1/vms/{id}/reset-password
🟢 Added — Rename VMs after creation — POST /api/v1/vms/{id}/rename

March 5, 2026

Volumes — API

🟢 Added — Resize block storage volumes attached to VMs — PATCH /api/v1/volumes/{id}

March 3, 2026

Projects — API

🟢 Added — Organize resources into projects — full CRUD via API
- GET /api/v1/projects · POST /api/v1/projects · GET /api/v1/projects/{id} · PUT /api/v1/projects/{id} · DELETE /api/v1/projects/{id}

March 1, 2026

Virtual Machines — API

🟢 Added — Full VM lifecycle — create, list, get details, delete
- GET /api/v1/vms · POST /api/v1/vms · GET /api/v1/vms/{id} · DELETE /api/v1/vms/{id}
🟢 Added — VM power control — start, stop, reboot
- POST /api/v1/vms/{id}/start · POST /api/v1/vms/{id}/stop · POST /api/v1/vms/{id}/reboot
🟢 Added — Scale resources — resize CPU and RAM on demand — POST /api/v1/vms/{id}/resize

Catalog — API

🟢 Added — Browse available resources — regions, OS templates, pricing (no auth required)
- GET /api/v1/public/regions · GET /api/v1/public/templates
- GET /api/v1/public/pricing/vm · /volume · /snapshot · /backup · /ip

Getting Started

Guides

REST API

CLI

Terraform

API Changelog

API Changelog

v1.0.0 (Beta)

August 28, 2026

August 27, 2026

August 26, 2026

August 25, 2026

August 24, 2026

August 23, 2026

August 20, 2026

July 28, 2026

July 20, 2026

July 12, 2026

July 8, 2026

July 6, 2026

May 25, 2026

May 14, 2026

May 10, 2026

May 8, 2026

April 30, 2026

April 29, 2026

March 25, 2026

March 15, 2026

March 10, 2026

March 5, 2026

March 3, 2026

March 1, 2026

​API Changelog

​v1.0.0 (Beta)

​August 28, 2026

​August 27, 2026

​August 26, 2026

​August 25, 2026

​August 24, 2026

​August 23, 2026

​August 20, 2026

​July 28, 2026

​July 20, 2026

​July 12, 2026

​July 8, 2026

​July 6, 2026

​May 25, 2026

​May 14, 2026

​May 10, 2026

​May 8, 2026

​April 30, 2026

​April 29, 2026

​March 25, 2026

​March 15, 2026

​March 10, 2026

​March 5, 2026

​March 3, 2026

​March 1, 2026

API Changelog

v1.0.0 (Beta)

August 28, 2026

August 27, 2026

August 26, 2026

August 25, 2026

August 24, 2026

August 23, 2026

August 20, 2026

July 28, 2026

July 20, 2026

July 12, 2026

July 8, 2026

July 6, 2026

May 25, 2026

May 14, 2026

May 10, 2026

May 8, 2026

April 30, 2026

April 29, 2026

March 25, 2026

March 15, 2026

March 10, 2026

March 5, 2026

March 3, 2026

March 1, 2026