{
  "openapi": "3.0.3",
  "info": {
    "title": "Trivox Reseller API",
    "description": "**Changelog:** [docs.trivox.sh/changelog](https://docs.trivox.sh/changelog) lists added and changed endpoints per API version.\n\n## Authentication\n- **`GET /dedicated/list`** requires **`X-API-Key`** with at least **Public**-tier permissions (accepts **Public**, **Secret**, or **Administrator** keys).\n- **`GET /vps/list`** does **not** require an API key.\n- **All other endpoints** require a **Secret** or **Administrator** reseller API key. **Public** keys are **not** accepted on those routes (you will receive `403` with insufficient permissions).\n- Send the key as header **`X-API-Key`**, or as query parameter **`apiKey`** (header preferred).\n- Keys can enforce **expiry** and **IP allowlists**; disabled keys return `403`.\n\n## Reseller access\n**Becoming a reseller** is not automatic: **apply** for reseller access; after approval you get panel access and API keys.\n**Negative balance** is an optional panel feature for approved resellers: you set a **EUR limit** and choose per product type what may use it — **dedicated** orders, renews, auto-renews and traffic add-ons, and **VPS** orders, renews, auto-renews and add-ons (IPv4, IPv6 /64, traffic). When allowed, the wallet may go down to **`−limit`** (see the dedicated and VPS order / billing sections). Negative amounts must be repaid within 5 days (plus 2 days grace); after that all services are suspended until the wallet is back to 0.00 € or higher.\n- Apply: [trivox.sh/reseller/apply-for-reseller/](https://trivox.sh/reseller/apply-for-reseller/)\n- API keys: [v2.trivox.sh/reseller/apiManager](https://v2.trivox.sh/reseller/apiManager)\n\n## Dedicated catalog\n**`GET /dedicated/list`** requires an active reseller **`X-API-Key`** (Public-, Secret-, or Administrator-type). Optional query **`price=public`** or **`price=trivox`** returns the public list price field as `price` on each server row. By default, items include **`resellerPrice`**. Optional query **`locationCode`** filters by datacenter: omit, empty, or **`all`** returns every site; **`TV-DB`** / **`databarn`** is Databarn; **`TV-NC`** / **`northc`** is NorthC. Alias query **`datacenter`** is accepted when **`locationCode`** is omitted. Unknown values return **400**. **`processorCores`** / **`processorThreads`** are **system totals** (per-CPU × **`processorCount`**).\n\n**Dedicated traffic (Reseller API vs retail):** `GET/POST /resellerApi/dedicated/{id}/traffic-addon/*` uses reseller traffic env (`TRAFFIC_RESELLER_DEDI_*`). **`GET /dedicated/list`** returns the same reseller-tier **`trafficUpgrades`** keys/prices as **`POST /dedicated/order`** (retail traffic tiers are only on **`GET /api/dedicateProducts`** / customer panel). The customer website and panel use **`GET /api/dedicateProducts`** and **`/api/dedicated/.../traffic-addon/*`** with **`TRAFFIC_DEDI_*`** only so displayed prices match billed amounts.\n\n**Traffic auto-expand:** `GET/PATCH .../traffic-addon/auto-expand` and `POST .../auto-expand/reset-spent` (VPS + Dedicated) configure automatic one-time top-ups when usage reaches **95%** of the effective limit. Default is **disabled**. Optional **`maxPrice`** is a cumulative spending budget since last reset; omit/`null` for no cap.\n\n## VPS\nVPS uses the **public** plan price from the catalog (`price` on `GET /vps/list`). **`POST /vps/order` does not apply reseller order discounts** — billing uses list price only. There are **no reseller ASN / BYOIP** flows for VPS; networking uses **Trivox-managed** provider pools (optional extra IPv4 (`vpsIpv4AddonExtraIps`) and IPv6 /64 packs (`vpsIpv6AddonKey`) at order time). **VPS rDNS** is limited to **Trivox IPv4 pools** (same idea as dedicated rDNS). **VPS power** actions are **`boot`**, **`shutdown`**, **`restart`**, **`poweroff`** (not the dedicated `start`/`stop` names).\n\n## Identifiers\n- **`id` in dedicated paths** is the dedicated server id (service id).\n- **`id` in VPS paths** is the VPS service id (`virtualServerKvm.id`).\n- **Dedicated subnet selection** uses **`subnetId`** from **`GET /ip-subnets/asn-assignments/with-ranges`** (one id per owned range). Each range has **`location`**: `TV-DB` (Databarn) or `TV-NC` (NorthC). `POST /dedicated/order` with `ipMode=provider` only accepts ranges that match the server **`locationCode`**.\n\n## Webhooks (outbound)\n\nResellers receive **outbound webhooks** for lifecycle events (orders, billing, network, delivery failures). Configure them in the panel: [v2.trivox.sh/reseller/webhooks](https://v2.trivox.sh/reseller/webhooks).\n\nThese routes live under **/api/reseller/webhooks/** on the panel API (**not** apiv2.trivox.sh/resellerApi). Authenticate with your panel session: `Authorization: Bearer <token>` (reseller role required).\n\n### IPN webhooks (signed JSON)\n\nTrivox POSTs JSON to your **primary** URL (optional **failover** URL). Each delivery includes:\n\n| Header | Description |\n|--------|-------------|\n| `X-Trivox-Signature` | HMAC-SHA256 hex of `${timestamp}.${raw_json_body}` using your webhook secret |\n| `X-Trivox-Timestamp` | Unix time (seconds) used in the signature |\n| `X-Trivox-Event` | Event type key (e.g. `dedicated.order.created`) |\n\nEnvelope:\n\n```json\n{\n  \"event\": \"dedicated.order.created\",\n  \"timestamp\": \"2026-06-22T12:00:00.000Z\",\n  \"data\": { \"orderId\": 456, \"productId\": 123 }\n}\n```\n\n**Payload format:** `classic` (default) keeps native JSON types in `data`; `all_strings` stringifies all values recursively.\n\n**Retries:** up to `deliveryMaxTries` (1–20) on the primary URL, then one attempt on the failover URL if set. When all attempts fail, optional recurring `system.webhook.delivery_failed` notifications are scheduled (`failureNotifyCount` × `failureNotifyIntervalMinutes`, each 1–30).\n\n**Event subscriptions:** toggle individual event types via `eventSubscriptions` in IPN settings. Test deliveries use event `ipn.test`.\n\n**Discord mirrors:** optional Discord webhook URLs receive the same payload (Discord format, unsigned).\n\n**Verify signature:**\n\n```\nexpected = HMAC_SHA256(secret, timestamp + \".\" + rawRequestBody)\ntiming-safe compare expected to X-Trivox-Signature\n```\n\n### Dedicated stock alerts (Discord only)\n\nSeparate from IPN: Discord notifications when dedicated inventory becomes available. Configured on **Dedicated Servers** in the panel (`/api/reseller/webhooks/dedicated-stock/config`). Uses a Trivox embed template or custom JSON — **no HMAC signing**.\n\n## Errors\nMost errors return JSON `{ \"success\": false, \"message\": \"...\" }` with an appropriate HTTP status (`400`, `401`, `403`, `404`, `500`).\n\nSupport: [Discord](https://dc.trivox.sh) · [Telegram](https://t.me/trivoxsh).",
    "version": "1.3.64",
    "contact": {
      "name": "Trivox",
      "url": "https://trivox.sh/"
    }
  },
  "servers": [
    {
      "url": "https://apiv2.trivox.sh/resellerApi",
      "description": "Production"
    },
    {
      "url": "https://v2.trivox.sh/api",
      "description": "Reseller panel API (JWT)"
    }
  ],
  "tags": [
    {
      "name": "IP subnets",
      "description": "Owned ASN assignments, assignable IPs, reservations, ASN traffic graphs, BGP session renewals, and LIR renewals for ASN assignments and IP ranges."
    },
    {
      "name": "Orders",
      "description": "Dedicated catalog (`GET /dedicated/list`, **X-API-Key** min. Public tier) and **`POST /dedicated/order`**. Reseller **negative balance** (panel, limit, allow for orders) can apply to new orders when enabled."
    },
    {
      "name": "Dedicated",
      "description": "List, detail, rename, IP assignment, IP description/primary, and SSH keys on dedicated servers."
    },
    {
      "name": "Power",
      "description": "Power control and status."
    },
    {
      "name": "Console",
      "description": "Remote console access: dedicated KVM URL and VPS HTML5 VNC credentials."
    },
    {
      "name": "Traffic",
      "description": "Traffic graphs and statistics."
    },
    {
      "name": "rDNS",
      "description": "Reverse DNS (PTR) for eligible IPv4 addresses. **Trivox IP ranges only:** these endpoints target Trivox-managed address space (Cloudflare-backed PTR). If you use **BYOIP** (bring your own IP subnets), this API **does not** apply — manage rDNS in your own infrastructure or with your RIR/ISP."
    },
    {
      "name": "OS / reinstall",
      "description": "Reinstall, abort reinstall, and SSH keys injected at install time."
    },
    {
      "name": "Billing",
      "description": "Dedicated auto-renew, email expiry, **manual renewal** (`POST .../billing/renew`), and **traffic add-ons**. Reseller **negative balance** applies to **platform auto-renew** when the panel limit is enabled (orders, dedicated renews, or auto-renews). Manual `POST .../billing/renew` can use the same **`−limit`** when **allow for dedicated server renews** or **allow for auto-renews** is enabled. Orders alone do not unlock that manual renew. Traffic add-on purchases use the limit when **allow for dedicated traffic addons** is enabled."
    },
    {
      "name": "VPS",
      "description": "KVM VPS catalog, orders at public list price, lifecycle, HTML5 VNC console credentials, extra IPv4 and IPv6 /64 add-ons, package upgrades, activity, and billing. No BYOIP / no reseller subnet APIs. Reseller **negative balance** can apply to **`POST /vps/order`** (**allow for VPS orders**) and to IPv4 / IPv6 /64 add-ons (**allow for VPS addons**) when enabled in the panel."
    },
    {
      "name": "VPS billing",
      "description": "VPS renewals, traffic add-ons, auto-renew and email flags. Renew requires the upstream VM to still exist (not removed after the post-expiry grace period). Reseller **negative balance** applies to manual renew (**allow for VPS renews** or **VPS auto-renews**), to platform auto-renew (**VPS auto-renews**, **VPS renews** or **VPS orders**), and to traffic add-ons (**allow for VPS addons**). Price endpoints return **`negativeBalanceAvailable`**."
    },
    {
      "name": "Webhooks (IPN)",
      "description": "Outbound signed JSON webhooks for reseller lifecycle events. Panel JWT on `https://v2.trivox.sh/api/reseller/webhooks/ipn/*`."
    },
    {
      "name": "Webhooks (Dedicated stock)",
      "description": "Discord alerts when dedicated stock is available. Separate from IPN; panel JWT on `/api/reseller/webhooks/dedicated-stock/*`."
    }
  ],
  "security": [
    {
      "ResellerSecretKey": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ResellerSecretKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "Reseller API key of type **Secret** or **Administrator**. Public keys cannot call protected routes."
      },
      "ResellerCatalogKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "Reseller API key with at least **Public**-tier access: **Public**, **Secret**, or **Administrator**. Required for **`GET /dedicated/list`**."
      },
      "PanelJwtBearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "Panel session token from login (`Authorization: Bearer <token>`). Requires an approved **Reseller** account."
      }
    },
    "parameters": {
      "DedicatedId": {
        "name": "id",
        "in": "path",
        "required": true,
        "description": "Dedicated server (service) id.",
        "schema": {
          "type": "integer",
          "minimum": 1
        }
      },
      "VpsId": {
        "name": "id",
        "in": "path",
        "required": true,
        "description": "VPS service id (`virtualServerKvm.id`).",
        "schema": {
          "type": "integer",
          "minimum": 1
        }
      },
      "AsnAssignmentId": {
        "name": "id",
        "in": "path",
        "required": true,
        "description": "ASN assignment id (`asnAssignmentId` from `GET /ip-subnets/asn-assignments/with-ranges`).",
        "schema": {
          "type": "integer",
          "minimum": 1
        }
      },
      "IpRangeId": {
        "name": "id",
        "in": "path",
        "required": true,
        "description": "IP range id (`ranges[].subnetId` from `GET /ip-subnets/asn-assignments/with-ranges`).",
        "schema": {
          "type": "integer",
          "minimum": 1
        }
      }
    },
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "message": {
            "type": "string"
          }
        }
      },
      "TrafficAutoExpandSettings": {
        "type": "object",
        "description": "Per-service auto-expand settings. When enabled, a one-time traffic top-up of `tbAmount` TB is purchased automatically once usage reaches `triggerPercent` of the effective traffic limit (default 95%). Charges use the one-time price per TB and the account wallet balance. `maxPrice` is an optional cumulative spending budget since the last reset (`null` = no cap).",
        "properties": {
          "enabled": {
            "type": "boolean",
            "example": false
          },
          "tbAmount": {
            "type": "integer",
            "minimum": 1,
            "example": 1
          },
          "maxPrice": {
            "type": "number",
            "nullable": true,
            "description": "Optional total spending limit in EUR for auto-expand purchases since last reset. `null` means unlimited.",
            "example": 50
          },
          "spentAmount": {
            "type": "number",
            "description": "EUR spent on auto-expand purchases since last reset.",
            "example": 0
          },
          "remainingBudget": {
            "type": "number",
            "nullable": true,
            "description": "`maxPrice - spentAmount` when a limit is set; otherwise `null`.",
            "example": 50
          },
          "triggerPercent": {
            "type": "integer",
            "example": 95
          },
          "minTb": {
            "type": "integer",
            "example": 1
          },
          "maxTb": {
            "type": "integer",
            "example": 100
          },
          "pricePerTB": {
            "type": "number",
            "description": "One-time EUR/TB rate used for auto-expand purchases.",
            "example": 1
          },
          "serviceType": {
            "type": "string"
          },
          "serviceId": {
            "type": "integer"
          },
          "userId": {
            "type": "integer",
            "nullable": true
          },
          "exists": {
            "type": "boolean"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "TrafficAutoExpandUpdateRequest": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Enable or disable auto-expand. Defaults to disabled when unset / never configured."
          },
          "tbAmount": {
            "type": "integer",
            "minimum": 1,
            "description": "TB amount to buy automatically when the trigger threshold is reached."
          },
          "maxPrice": {
            "type": "number",
            "nullable": true,
            "description": "Optional cumulative spending budget in EUR. Send `null` or omit empty to clear the limit."
          }
        }
      },
      "DedicatedOrderRequest": {
        "type": "object",
        "required": [
          "productId"
        ],
        "properties": {
          "productId": {
            "type": "integer",
            "description": "Dedicated product id from `GET /dedicated/list` (`id` on catalog items)."
          },
          "trafficUpgradeKey": {
            "type": "string",
            "nullable": true,
            "description": "Optional traffic package key from catalog `trafficUpgrades`."
          },
          "ipMode": {
            "type": "string",
            "enum": [
              "own",
              "provider"
            ],
            "description": "`own`: default product / DC IP assignment (no reseller subnet logic). `provider`: assign from **your** (reseller-owned) subnets. For `provider`, **`subnetId` is optional**: if you omit subnet **and** omit explicit IPs, the backend **auto-selects** the first free IPv4 it finds across all subnets on your account (same server-side logic as the panel — not a separate “customer” API). Use **`subnetId`** only when you want a specific range or together with `selectedAssignableIp` / `selectedAssignableIps`."
          },
          "subnetId": {
            "type": "integer",
            "description": "Optional subnet id for `ipMode=provider` (from `GET /ip-subnets/asn-assignments/with-ranges`). Omit to let the backend pick an IP automatically; set when you want a specific subnet or when supplying explicit `selectedAssignable*` IPs for one subnet."
          },
          "selectedAssignableIp": {
            "type": "string",
            "description": "For `provider`: one concrete IP to assign (usually together with a resolved subnet, or after you listed assignable IPs). Not required if the backend auto-picks."
          },
          "selectedAssignableIps": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "For `provider`: multiple IPs (same subnet when using the single-subnet fields). Not required if the backend auto-picks."
          },
          "ipAssignments": {
            "type": "array",
            "description": "Multiple subnet groups (IPv4/IPv6 mix). Each entry: `subnetId` plus `ips[]`.",
            "items": {
              "type": "object",
              "properties": {
                "subnetId": {
                  "type": "integer"
                },
                "ips": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "autoRenew": {
            "type": "boolean",
            "description": "If set, overrides default auto-renew behavior for the order."
          },
          "reseller": {
            "type": "boolean",
            "description": "Legacy: when `autoRenew` is omitted, `reseller: true` implies auto-renew off (`!reseller`). Prefer `autoRenew`."
          },
          "dedicatedIpv6AddonKey": {
            "type": "integer",
            "minimum": 1,
            "maximum": 64,
            "description": "Total IPv6 /64 count including the one included with the plan (any integer >= 1, max 64). Example: `5` = 4 extras at 1.50 € each per month. Prefer `dedicatedIpv6AddonExtraSubnets` when you already know extras. Assigned from the Databarn or NorthC pool matching the product site."
          },
          "dedicatedIpv6AddonExtraSubnets": {
            "type": "integer",
            "minimum": 0,
            "maximum": 63,
            "description": "Extra /64 count beyond the included one. Any non-negative integer (billed at 1.50 € each per month). Overrides derivation from `dedicatedIpv6AddonKey` when set."
          },
          "ipv6AddonExtraSubnets": {
            "type": "integer",
            "description": "Alias of `dedicatedIpv6AddonExtraSubnets`."
          },
          "ipv6AddonKey": {
            "type": "integer",
            "description": "Alias of `dedicatedIpv6AddonKey`."
          },
          "dedicatedIpv4AddonSubnet": {
            "type": "string",
            "enum": [
              "/32",
              "/30",
              "/29",
              "/28"
            ],
            "description": "Shortcut for a Trivox IPv4 addon pack at order time. Only `/32` (0 extras), `/30` (+3), `/29` (+7), and `/28` (+15) are packs, billed at 2.50 EUR per extra address per month. Addresses are taken from every Trivox range at that datacenter that still has free space. Any other size is treated as `/32` and adds no extras. For any other count (0–63), set `dedicatedIpv4AddonExtraIps` instead; that field overrides this shortcut."
          },
          "dedicatedIpv4AddonExtraIps": {
            "type": "integer",
            "minimum": 0,
            "maximum": 63,
            "description": "Extra IPv4 count beyond the included one. Overrides derivation from `dedicatedIpv4AddonSubnet` when set. Billed at 2.50 EUR each per month."
          },
          "ipv4AddonSubnet": {
            "type": "string",
            "description": "Alias of `dedicatedIpv4AddonSubnet`."
          },
          "ipv4AddonExtraIps": {
            "type": "integer",
            "description": "Alias of `dedicatedIpv4AddonExtraIps`."
          }
        }
      },
      "ReserveIpRequest": {
        "type": "object",
        "description": "Reserve addresses on an owned subnet (`subnetId` from `GET /ip-subnets/asn-assignments/with-ranges`). Send **`application/json`** (not form-data).\n\n**`type` values:**\n- **`singleIp`** — host address(es). Use **`ip`** (one) or **`ips`** (several). Typical for IPv4 from `GET /ip-ranges/assignable`.\n- **`subnet`** — whole subnet row(s) (mainly IPv6). Use **`ip`** or **`ips`** with CIDR notation, e.g. `2001:db8:1234::/48`.",
        "required": [
          "subnetId",
          "type"
        ],
        "properties": {
          "subnetId": {
            "type": "integer"
          },
          "type": {
            "type": "string",
            "enum": [
              "singleIp",
              "subnet"
            ],
            "description": "`singleIp` for a host address; `subnet` for a prefix/CIDR block."
          },
          "ip": {
            "type": "string",
            "description": "Single target: IPv4/IPv6 address (`singleIp`) or CIDR (`subnet`)."
          },
          "ips": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Multiple targets for the chosen `type` (host addresses for `singleIp`, CIDR prefixes for `subnet`). Processed in order; duplicates skipped."
          }
        }
      },
      "TrafficRequestBody": {
        "type": "object",
        "description": "Either a preset string is not used here — send an object. `predefined` selects the window.",
        "properties": {
          "predefined": {
            "type": "string",
            "enum": [
              "today",
              "1h",
              "24h",
              "14days",
              "30days",
              "all",
              "currentWeek",
              "week",
              "month",
              "currentMonth",
              "year"
            ],
            "default": "24h",
            "description": "Time window for traffic data."
          },
          "from": {
            "type": "string",
            "description": "Optional start (passed through when using advanced stats)."
          },
          "to": {
            "type": "string",
            "description": "Optional end."
          },
          "groupBy": {
            "type": "string"
          },
          "summary": {
            "type": "boolean",
            "description": "For advanced stats mode."
          },
          "statsMode": {
            "type": "string",
            "enum": [
              "graph",
              "text"
            ],
            "description": "When combined with groupBy/summary, selects TenantOS stats presentation."
          }
        }
      },
      "ReinstallRequest": {
        "type": "object",
        "description": "Profile ids come from `GET /dedicated/{id}` → `availableOs` / `availableRescue` (`versions[].id`). Use **`profileId`** only (not `image`). Use **`rootPassword`** only (not `rootpassword`). Optional **`sshKeys`** are account key ids from `GET /dedicated/{id}/ssh-keys`; they are injected only when the selected profile has **`allowSshKeys: true`**.",
        "properties": {
          "disklayoutId": {
            "type": "integer",
            "description": "Disk layout id for the install."
          },
          "raid": {
            "type": "string",
            "description": "Optional RAID/layout label (resolved server-side when configured). When omitted, the backend picks from this server's `product.raidLevels` (from `GET /dedicated/{id}`): the only supported option if there is just one; otherwise **Install on smallest disk** is preferred when available, else the first supported option in product order. **Automatic Partitioning** is never used as a global default."
          },
          "profileId": {
            "type": "integer",
            "description": "OS or rescue profile id."
          },
          "rootPassword": {
            "type": "string",
            "description": "Root password for the installed system."
          },
          "runScripts": {
            "type": "array",
            "items": {},
            "description": "Optional post-install scripts payload."
          },
          "mode": {
            "type": "string",
            "enum": [
              "os",
              "resecure"
            ],
            "description": "Use `os` for a full OS install (default) or `resecure` for rescue."
          },
          "sshKeys": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Optional SSH key ids from `GET /dedicated/{id}/ssh-keys`. Injected at install time. Rejected when the selected profile has `allowSshKeys: false`."
          }
        }
      },
      "DedicatedSshKey": {
        "type": "object",
        "description": "SSH key stored on your Trivox account for dedicated install/reinstall.",
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "publicKey": {
            "type": "string"
          },
          "fingerprint": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "VpsServicePublic": {
        "type": "object",
        "description": "Public VPS service row (no `userId`, `externalId`, or user profile fields).",
        "properties": {
          "id": {
            "type": "integer"
          },
          "hostname": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "price": {
            "type": "string"
          },
          "cores": {
            "type": "integer"
          },
          "ramGb": {
            "type": "integer"
          },
          "storage": {
            "type": "string"
          },
          "portSpeedGbps": {
            "type": "number"
          },
          "trafficLimitTB": {
            "type": "string"
          },
          "trafficUsageTB": {
            "type": "string"
          },
          "ipv4Address": {
            "type": "string",
            "nullable": true
          },
          "ipv6Address": {
            "type": "string",
            "nullable": true
          },
          "powerStatus": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "autoRenew": {
            "type": "string"
          },
          "emailExpiry": {
            "type": "string"
          },
          "build": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "VpsBuildRequest": {
        "type": "object",
        "required": [
          "operatingSystemId"
        ],
        "description": "Start install/reinstall on an existing VPS. Pick **`operatingSystemId`** from `GET /vps/{id}/templates` → `templates[].templates[].id` (e.g. Debian 12 → `12`).",
        "properties": {
          "operatingSystemId": {
            "type": "integer",
            "description": "Template id from `GET /vps/{id}/templates` (leaf `templates[].id`, not the OS family id)."
          },
          "operatingSystemLabel": {
            "type": "string",
            "description": "Optional label for the build email (e.g. `Debian 12 (Bookworm)`)."
          },
          "hostname": {
            "type": "string",
            "maxLength": 16,
            "description": "Optional FQDN (must include a TLD, e.g. `vm.example.com`), max 16 characters. Defaults to the service hostname when omitted."
          },
          "name": {
            "type": "string",
            "description": "Optional display name for the VPS; defaults to the current service name."
          },
          "vnc": {
            "type": "boolean",
            "description": "Enable VNC for install."
          },
          "swap": {
            "type": "number",
            "minimum": 0,
            "description": "Swap size in GB (optional)."
          },
          "sshKeys": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Ids from `GET /vps/{id}/ssh-keys` to inject at install time."
          }
        }
      },
      "RdnsPtrData": {
        "type": "object",
        "properties": {
          "ip": {
            "type": "string",
            "format": "ipv4"
          },
          "ptr": {
            "type": "string",
            "nullable": true,
            "description": "FQDN PTR target, or null if unset."
          }
        }
      },
      "VpsSshKey": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "publicKey": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "VpsVncSession": {
        "type": "object",
        "description": "Short-lived HTML5 VNC session credentials for noVNC or compatible clients. VNC is enabled when missing and auto-disabled after **`autoDisableMinutes`** (default 60) for security.",
        "properties": {
          "wssUrl": {
            "type": "string",
            "format": "uri",
            "description": "WebSocket URL for an HTML5 VNC client (e.g. noVNC `RFB` target)."
          },
          "password": {
            "type": "string",
            "nullable": true,
            "description": "VNC password; pass as `credentials.password` to noVNC."
          },
          "ip": {
            "type": "string",
            "nullable": true,
            "description": "Internal VNC host (informational)."
          },
          "port": {
            "type": "integer",
            "nullable": true,
            "description": "Internal VNC port (informational)."
          },
          "enabled": {
            "type": "boolean",
            "description": "Whether VNC is currently enabled on the server."
          },
          "autoDisableMinutes": {
            "type": "integer",
            "nullable": true,
            "description": "Minutes until VNC is automatically disabled again (null if auto-disable is off)."
          }
        },
        "required": [
          "wssUrl"
        ]
      },
      "IpnSettings": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "webhookUrl": {
            "type": "string",
            "format": "uri"
          },
          "failoverWebhookUrl": {
            "type": "string",
            "format": "uri"
          },
          "payloadFormat": {
            "type": "string",
            "enum": [
              "classic",
              "all_strings"
            ]
          },
          "deliveryMaxTries": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "example": 5
          },
          "failureNotifyCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 30,
            "example": 10
          },
          "failureNotifyIntervalMinutes": {
            "type": "integer",
            "minimum": 1,
            "maximum": 30,
            "example": 3
          },
          "customPayloadText": {
            "type": "string"
          },
          "webhookSecretMasked": {
            "type": "string",
            "nullable": true,
            "example": "a1b2…c3d4"
          },
          "hasSecret": {
            "type": "boolean"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "eventSubscriptions": {
            "type": "object",
            "additionalProperties": {
              "type": "boolean"
            },
            "description": "Map of event key → enabled."
          },
          "eventCatalog": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IpnEventCatalogEntry"
            }
          }
        }
      },
      "IpnEventCatalogEntry": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "example": "dedicated.order.created"
          },
          "category": {
            "type": "string",
            "example": "Dedicated Servers"
          },
          "label": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "samplePayload": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "IpnDiscordWebhook": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "label": {
            "type": "string",
            "maxLength": 120
          },
          "webhookUrl": {
            "type": "string",
            "format": "uri"
          },
          "enabled": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "IpnDeliveryLog": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "eventType": {
            "type": "string"
          },
          "deliveryKind": {
            "type": "string",
            "enum": [
              "primary",
              "failover",
              "discord",
              "failure_notify"
            ]
          },
          "targetUrl": {
            "type": "string",
            "nullable": true
          },
          "payloadJson": {
            "type": "string",
            "nullable": true
          },
          "responseStatus": {
            "type": "integer",
            "nullable": true
          },
          "responseBody": {
            "type": "string",
            "nullable": true
          },
          "attemptNumber": {
            "type": "integer"
          },
          "maxAttempts": {
            "type": "integer"
          },
          "status": {
            "type": "string",
            "enum": [
              "success",
              "failed",
              "pending",
              "scheduled"
            ]
          },
          "errorMessage": {
            "type": "string",
            "nullable": true
          },
          "signature": {
            "type": "string",
            "nullable": true
          },
          "scheduledFor": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "DedicatedStockWebhookConfig": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "mode": {
            "type": "string",
            "enum": [
              "trivox",
              "custom"
            ]
          },
          "templateConfig": {
            "type": "object",
            "additionalProperties": true
          },
          "customPayloadText": {
            "type": "string"
          }
        }
      }
    }
  },
  "paths": {
    "/dedicated/list": {
      "get": {
        "tags": [
          "Orders"
        ],
        "summary": "Dedicated catalog",
        "description": "Dedicated products and **`trafficUpgrades`** (reseller-tier keys, same as **`POST /dedicated/order`**). Each catalog item includes **`raidOptions`** (`string[]`, derived from product `raidLevels`) for reinstall provisioning. CPU specs: **`processorCount`** is installed CPU packages; **`processorCores`** / **`processorThreads`** are **system totals** (per-CPU × `processorCount`). Also **`processorFrequence`** (base clock, GHz string) and **`processorTurboFrequence`** (max turbo clock, GHz string; `null` when unknown). Site is **`location`** (city), **`locationCode`** (`TV-DB` Databarn or `TV-NC` NorthC), and **`datacenter`**. Optional query **`locationCode`** (alias **`datacenter`**) filters to one site; omit, empty, or **`all`** returns every site. Response includes **`trafficPricingSource`** (`reseller` for this route). Requires **`X-API-Key`** with Public-tier-or-higher key (**Public**, **Secret**, or **Administrator**; query `apiKey` is also supported).",
        "operationId": "listDedicatedCatalog",
        "security": [
          {
            "ResellerCatalogKey": []
          }
        ],
        "parameters": [
          {
            "name": "price",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "public",
                "trivox"
              ]
            },
            "description": "If `public` or `trivox`, each item exposes public `price` for the server line item. **`trafficUpgrades`** always use reseller-tier keys/prices (not retail `TRAFFIC_DEDI_*` list tiers)."
          },
          {
            "name": "locationCode",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "TV-DB",
                "TV-NC",
                "databarn",
                "northc",
                "DB",
                "NC"
              ]
            },
            "description": "Filter catalog rows by datacenter. Omit, empty, or `all` returns every site (default). `TV-DB` / `databarn` / `DB` = Databarn, `TV-NC` / `northc` / `NC` = NorthC. Alias query `datacenter` is accepted when `locationCode` is omitted. Unknown values return 400."
          },
          {
            "name": "datacenter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "TV-DB",
                "TV-NC",
                "databarn",
                "northc",
                "DB",
                "NC"
              ]
            },
            "description": "Alias for `locationCode`. Ignored when `locationCode` is set. Same values as `locationCode`, including `DB` and `NC`."
          }
        ],
        "responses": {
          "200": {
            "description": "Product rows and traffic upgrade options.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    },
                    "trafficUpgrades": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    },
                    "trafficPricingSource": {
                      "type": "string",
                      "enum": [
                        "reseller"
                      ],
                      "description": "Always `reseller`: `trafficUpgrades` use reseller-tier env keys/prices (same as `POST /dedicated/order`)."
                    }
                  },
                  "example": {
                    "success": true,
                    "data": [
                      {
                        "id": 101,
                        "hostname": "TV-DB1-SRV01",
                        "location": "Netherlands AMS",
                        "locationCode": "TV-DB",
                        "datacenter": "Databarn",
                        "processorBrand": "AMD EPYC",
                        "processor": "7543P",
                        "processorCores": 32,
                        "processorThreads": 64,
                        "processorCount": 1,
                        "processorFrequence": "2.80",
                        "processorTurboFrequence": "4.00",
                        "ramAmount": 128,
                        "ramType": "DDR4",
                        "storageFirst": "960GB",
                        "storageFirstType": "NVMe",
                        "storageFirstAmount": 2,
                        "storageSecond": null,
                        "storageSecondType": null,
                        "storageSecondAmount": null,
                        "ipv6Amount": 1,
                        "ipv4Amount": 1,
                        "subnetSizeIPV4": "/32",
                        "subnetSizeIPv6": "/48",
                        "portSpeed": "10 Gbit/s",
                        "trafficTB": "300.00",
                        "raidOptions": [
                          "raid 1",
                          "raid 10"
                        ],
                        "status": "Available",
                        "price": "219.99"
                      },
                      {
                        "id": 102,
                        "hostname": "TV-NC1-SRV02",
                        "location": "Netherlands AMS",
                        "locationCode": "TV-NC",
                        "datacenter": "NorthC",
                        "processorBrand": "Intel Xeon",
                        "processor": "Silver 4310",
                        "processorCores": 16,
                        "processorThreads": 32,
                        "processorCount": 2,
                        "processorFrequence": "2.10",
                        "processorTurboFrequence": "3.30",
                        "ramAmount": 64,
                        "ramType": "DDR4",
                        "storageFirst": "1TB",
                        "storageFirstType": "SSD",
                        "storageFirstAmount": 1,
                        "storageSecond": "2TB",
                        "storageSecondType": "HDD",
                        "storageSecondAmount": 1,
                        "ipv6Amount": 1,
                        "ipv4Amount": 1,
                        "subnetSizeIPV4": "/32",
                        "subnetSizeIPv6": "/48",
                        "portSpeed": "1 Gbit/s",
                        "trafficTB": "120.00",
                        "raidOptions": [
                          "automatic partitioning"
                        ],
                        "status": "Available",
                        "price": "129.99"
                      }
                    ],
                    "trafficUpgrades": [
                      {
                        "key": "TRAFFIC_RESELLER_DEDI_3300",
                        "label": "3300",
                        "price": 299.99
                      },
                      {
                        "key": "TRAFFIC_RESELLER_DEDI_1650",
                        "label": "1650",
                        "price": 199.99
                      },
                      {
                        "key": "TRAFFIC_RESELLER_DEDI_990",
                        "label": "990",
                        "price": 99.99
                      }
                    ],
                    "trafficPricingSource": "reseller"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid `locationCode` / `datacenter` filter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Disabled/expired key, IP lock, or insufficient key type",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-subnets/asn-assignments/with-ranges": {
      "get": {
        "tags": [
          "IP subnets"
        ],
        "summary": "List ASN assignments with subnet ranges",
        "description": "Returns reseller-owned ASN assignments with subnet ranges. Each range includes **`subnetId`** for assignable IPs, orders, and IP assignment, and **`location`** (`TV-DB` or `TV-NC`) for the datacenter where that range may be used.",
        "operationId": "listAsnAssignmentsWithRanges",
        "responses": {
          "200": {
            "description": "Assignments or empty notice.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    },
                    "message": {
                      "type": "string",
                      "description": "Present when `data` is empty."
                    }
                  },
                  "example": {
                    "success": true,
                    "data": [
                      {
                        "bgpPrice": "18.00",
                        "asnPrice": null,
                        "asn": 1337,
                        "organization": "Example Networks BV",
                        "createdAt": "2026-01-08T09:15:30.000Z",
                        "asnCreatedAt": null,
                        "bgpCreatedAt": "2026-05-12T14:22:57.000Z",
                        "asnExpiresAt": null,
                        "bgpExpiresAt": "2026-06-18T16:23:50.000Z",
                        "lir": "False",
                        "bgp": "True",
                        "status": "Active",
                        "asnAssignmentId": 17,
                        "ranges": [
                          {
                            "asnAssignmentId": 17,
                            "price": null,
                            "ipVersion": "ipv4",
                            "subnetName": "Dedicated Range Alpha",
                            "prefix": "198.51.100.0",
                            "size": "/24",
                            "lir": "False",
                            "createdAt": "2026-02-03T11:05:12.000Z",
                            "expiresAt": null,
                            "status": "Routed",
                            "location": "TV-DB",
                            "subnetId": 41
                          },
                          {
                            "asnAssignmentId": 17,
                            "price": null,
                            "ipVersion": "ipv6",
                            "subnetName": "Trivox V6 Example",
                            "prefix": "2001:db8:900::",
                            "size": "/40",
                            "lir": "False",
                            "createdAt": "2026-02-09T08:18:21.000Z",
                            "expiresAt": null,
                            "status": "Routed",
                            "location": "TV-DB",
                            "subnetId": 42
                          }
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-subnets/asn-assignments/{id}/bgp/renew/options": {
      "get": {
        "tags": [
          "IP subnets"
        ],
        "summary": "BGP renewal options",
        "description": "Returns wallet **`balance`**, current **`bgpExpiresAt`**, **`bgpAutoRenew`**, **`overdue`**, and term prices for this ASN assignment when BGP is enabled. Overdue assignments remain renewable until an administrator confirms expiry. Use **`months`** with `POST .../bgp/renew`.",
        "operationId": "getAsnBgpRenewOptionsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/AsnAssignmentId"
          }
        ],
        "responses": {
          "200": {
            "description": "BGP renewal options.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "bgpOptions": {
                    "summary": "BGP terms",
                    "value": {
                      "success": true,
                      "data": {
                        "options": [
                          {
                            "months": 1,
                            "total": 18
                          },
                          {
                            "months": 3,
                            "total": 54
                          },
                          {
                            "months": 6,
                            "total": 108
                          },
                          {
                            "months": 12,
                            "total": 216
                          }
                        ],
                        "balance": 120.5,
                        "bgpExpiresAt": "2026-09-18T16:23:50.000Z",
                        "bgpAutoRenew": false,
                        "overdue": false,
                        "blockedReason": null
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-subnets/asn-assignments/{id}/bgp/renew": {
      "post": {
        "tags": [
          "IP subnets"
        ],
        "summary": "Renew BGP session",
        "description": "Charges wallet and extends **`bgpExpiresAt`**. **`months`** must be `1`, `3`, `6`, or `12`. Works while overdue (including suspended) until an administrator confirms expiry. Prepaid terms add after the current expiry, or from now if already overdue.",
        "operationId": "renewAsnBgpReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/AsnAssignmentId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "months"
                ],
                "properties": {
                  "months": {
                    "type": "integer",
                    "enum": [
                      1,
                      3,
                      6,
                      12
                    ]
                  }
                }
              },
              "examples": {
                "renewBgp": {
                  "summary": "1 month",
                  "value": {
                    "months": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "BGP renewed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-subnets/asn-assignments/{id}/bgp/auto-renew": {
      "put": {
        "tags": [
          "IP subnets"
        ],
        "summary": "Toggle BGP auto-renew",
        "description": "Enable or disable monthly BGP auto-renew from wallet balance for this ASN assignment. Requires BGP enabled with a price greater than zero. Auto-renew runs when the BGP expiry is reached and stops after an administrator confirms expiry.",
        "operationId": "setAsnBgpAutoRenewReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/AsnAssignmentId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "enabled"
                ],
                "properties": {
                  "enabled": {
                    "type": "boolean",
                    "description": "Whether monthly auto-renew is enabled."
                  }
                }
              },
              "examples": {
                "enable": {
                  "summary": "Enable auto-renew",
                  "value": {
                    "enabled": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Auto-renew updated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "ok": {
                    "summary": "Enabled",
                    "value": {
                      "success": true,
                      "message": "BGP auto-renew enabled.",
                      "data": {
                        "bgpAutoRenew": true
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-subnets/asn-assignments/{id}/lir/renew/options": {
      "get": {
        "tags": [
          "IP subnets"
        ],
        "summary": "LIR / ASN renewal options",
        "description": "Yearly LIR / ASN renewal pricing when **`lir`** is enabled on the assignment. Use with `POST .../lir/renew`.",
        "operationId": "getAsnLirRenewOptionsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/AsnAssignmentId"
          }
        ],
        "responses": {
          "200": {
            "description": "LIR / ASN renewal options.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-subnets/asn-assignments/{id}/lir/renew": {
      "post": {
        "tags": [
          "IP subnets"
        ],
        "summary": "Renew LIR / ASN",
        "description": "Charges wallet and extends **`asnExpiresAt`**. **`months`** must be `12` (one year).",
        "operationId": "renewAsnLirReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/AsnAssignmentId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "months"
                ],
                "properties": {
                  "months": {
                    "type": "integer",
                    "enum": [
                      12
                    ]
                  }
                }
              },
              "examples": {
                "renewYear": {
                  "summary": "One year",
                  "value": {
                    "months": 12
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "LIR / ASN renewed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-subnets/asn-assignments/{id}/traffic": {
      "get": {
        "tags": [
          "IP subnets"
        ],
        "summary": "ASN traffic graph",
        "description": "Returns L3 bitrate time series for an **owned** ASN assignment only (assignment must belong to the API key owner). The ASN filter is taken from that assignment — clients cannot query arbitrary ASNs.\n\n**Required window:** query **`start`** and **`end`** as ISO-8601 or unix timestamps (seconds or ms). Duration must be between **1 hour** and **7 days**; `end` must be after `start` and not in the future.\n\n**Data center:** optional `location=ALL` (default) merges Databarn and NorthC; `TV-DB` Databarn; `TV-NC` NorthC.\n\n**Cooldown:** **20 seconds** per assignment → **429** with `Retry-After` / `retryAfterSeconds`. Incomplete trailing buckets are omitted.",
        "operationId": "getAsnAssignmentTraffic",
        "parameters": [
          {
            "$ref": "#/components/parameters/AsnAssignmentId"
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Window start (ISO-8601 or unix seconds/ms).",
            "example": "2026-10-09T12:00:00.000Z"
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Window end (ISO-8601 or unix seconds/ms). Must be after start; duration 1h–7d.",
            "example": "2026-10-10T12:00:00.000Z"
          },
          {
            "name": "location",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ALL",
                "TV-DB",
                "TV-NC"
              ],
              "default": "ALL"
            },
            "description": "`ALL` merges Databarn and NorthC. `TV-DB` Databarn. `TV-NC` NorthC."
          }
        ],
        "responses": {
          "200": {
            "description": "ASN traffic series and summary.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true,
                      "properties": {
                        "location": {
                          "type": "string",
                          "example": "ALL"
                        },
                        "asn": {
                          "type": "integer",
                          "example": 211507
                        },
                        "units": {
                          "type": "string",
                          "example": "l3bps"
                        },
                        "times": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "format": "date-time"
                          }
                        },
                        "series": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "example": "Outgoing"
                              },
                              "axis": {
                                "type": "string",
                                "example": "Direct"
                              },
                              "data": {
                                "type": "array",
                                "items": {
                                  "type": "number"
                                }
                              }
                            }
                          }
                        },
                        "summary": {
                          "type": "object",
                          "additionalProperties": true
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "asnTraffic48h": {
                    "summary": "Owned ASN traffic for a custom start/end window (truncated)",
                    "value": {
                      "success": true,
                      "data": {
                        "location": "ALL",
                        "locationLabel": "All locations",
                        "asn": 211507,
                        "units": "l3bps",
                        "start": "2026-10-08T23:00:00.000Z",
                        "end": "2026-10-10T23:00:00.000Z",
                        "times": [
                          "2026-10-08T23:10:00Z",
                          "2026-10-08T23:20:00Z"
                        ],
                        "series": [
                          {
                            "name": "Outgoing",
                            "axis": "Direct",
                            "data": [
                              17250000000,
                              18120000000
                            ]
                          },
                          {
                            "name": "Incoming",
                            "axis": "Reverse",
                            "data": [
                              16880000000,
                              17540000000
                            ]
                          }
                        ],
                        "summary": {
                          "perSeries": [
                            {
                              "name": "Outgoing",
                              "average": 17685000000,
                              "max": 18120000000,
                              "last": 18120000000,
                              "p95": 18120000000
                            },
                            {
                              "name": "Incoming",
                              "average": 17210000000,
                              "max": 17540000000,
                              "last": 17540000000,
                              "p95": 17540000000
                            }
                          ],
                          "total": {
                            "average": 34895000000,
                            "max": 35660000000,
                            "last": 35660000000,
                            "p95": 35660000000
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "ASN assignment not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "20s cooldown still active for this assignment.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until another request is allowed.",
                "schema": {
                  "type": "integer",
                  "example": 12
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false
                    },
                    "message": {
                      "type": "string"
                    },
                    "retryAfterSeconds": {
                      "type": "integer",
                      "example": 12
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Traffic source not configured for the requested location.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-ranges/assignable": {
      "get": {
        "tags": [
          "IP subnets"
        ],
        "summary": "List assignable free IPs in a subnet",
        "description": "Requires **`subnetId`** from `GET /ip-subnets/asn-assignments/with-ranges`. Returns free IPv4/IPv6 assignable in that owned subnet.",
        "operationId": "getAssignableIps",
        "parameters": [
          {
            "name": "subnetId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Subnet id from `GET /ip-subnets/asn-assignments/with-ranges` (owned by your account)."
          }
        ],
        "responses": {
          "200": {
            "description": "List of assignable IP strings.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "ips": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "format": "ipv4"
                      },
                      "description": "Free addresses in the subnet (may be long for large ranges)."
                    }
                  }
                },
                "examples": {
                  "assignableSample": {
                    "summary": "Example (truncated)",
                    "description": "Illustrative subset only; real responses can list every free host in the range.",
                    "value": {
                      "success": true,
                      "ips": [
                        "203.0.113.14",
                        "203.0.113.15",
                        "203.0.113.16",
                        "203.0.113.17",
                        "203.0.113.18",
                        "203.0.113.19"
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid subnetId",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Subnet not owned",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Subnet not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-subnets/ip-ranges/{id}/lir/renew/options": {
      "get": {
        "tags": [
          "IP subnets"
        ],
        "summary": "IP range LIR renewal options",
        "description": "Returns LIR renewal terms for an owned IP range. IPv4 uses `1/3/6/12` month terms; IPv6 is yearly (`12`). Response includes `autoRenew` (default on).",
        "operationId": "getIpRangeLirRenewOptionsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/IpRangeId"
          }
        ],
        "responses": {
          "200": {
            "description": "IP range LIR renewal options.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-subnets/ip-ranges/{id}/lir/renew": {
      "post": {
        "tags": [
          "IP subnets"
        ],
        "summary": "Renew IP range LIR",
        "description": "Charges wallet and extends the range expiry. Send **`months`** from the matching options endpoint.",
        "operationId": "renewIpRangeLirReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/IpRangeId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "months"
                ],
                "properties": {
                  "months": {
                    "type": "integer",
                    "enum": [
                      1,
                      3,
                      6,
                      12
                    ]
                  }
                }
              },
              "examples": {
                "renewIpv4": {
                  "summary": "IPv4 1 month",
                  "value": {
                    "months": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "IP range LIR renewed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-subnets/ip-ranges/{id}/lir/auto-renew": {
      "put": {
        "tags": [
          "IP subnets"
        ],
        "summary": "Toggle IP range LIR auto-renew",
        "description": "Enable or disable LIR auto-renew from wallet balance for this IP range. IPv4 renews 1 month; IPv6 renews 1 year when expiry is reached. Requires LIR billing with a price greater than zero. Default is enabled.",
        "operationId": "setIpRangeLirAutoRenewReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/IpRangeId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "enabled"
                ],
                "properties": {
                  "enabled": {
                    "type": "boolean",
                    "description": "Whether auto-renew is enabled."
                  }
                }
              },
              "examples": {
                "enable": {
                  "summary": "Enable auto-renew",
                  "value": {
                    "enabled": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Auto-renew updated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "ok": {
                    "summary": "Enabled",
                    "value": {
                      "success": true,
                      "message": "IP range auto-renew enabled.",
                      "data": {
                        "autoRenew": true
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ip-subnets/ip/reserve": {
      "post": {
        "tags": [
          "IP subnets"
        ],
        "summary": "Reserve IPs on an owned subnet",
        "description": "Reserves one or more addresses via **`ip`** or **`ips`** (see `ReserveIpRequest` for **`type`**). Per-target results in **`results`**; HTTP **400** if none succeeded.",
        "operationId": "reserveIps",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReserveIpRequest"
              },
              "examples": {
                "reserveSingleIpv4": {
                  "summary": "Reserve one IPv4",
                  "value": {
                    "subnetId": 91,
                    "type": "singleIp",
                    "ip": "203.0.113.14"
                  }
                },
                "reserveMultipleIpv4": {
                  "summary": "Reserve several IPv4s",
                  "value": {
                    "subnetId": 91,
                    "type": "singleIp",
                    "ips": [
                      "203.0.113.14",
                      "203.0.113.15"
                    ]
                  }
                },
                "reserveMultipleIpv6Subnets": {
                  "summary": "Reserve several IPv6 prefixes",
                  "value": {
                    "subnetId": 91,
                    "type": "subnet",
                    "ips": [
                      "2001:db8:1234::/48",
                      "2001:db8:1235::/48"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "At least one IP reserved.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "summary": {
                      "type": "object",
                      "properties": {
                        "requested": {
                          "type": "integer"
                        },
                        "reserved": {
                          "type": "integer"
                        },
                        "failed": {
                          "type": "integer"
                        }
                      }
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "ip": {
                            "type": "string"
                          },
                          "success": {
                            "type": "boolean"
                          },
                          "data": {
                            "type": "object"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "reserveSuccess": {
                    "summary": "One IPv4 reserved",
                    "value": {
                      "success": true,
                      "summary": {
                        "requested": 1,
                        "reserved": 1,
                        "failed": 0
                      },
                      "results": [
                        {
                          "ip": "203.0.113.14",
                          "success": true,
                          "data": {
                            "result": "ok",
                            "message": "success"
                          }
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Validation error or all reservations failed",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Subnet not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/order": {
      "post": {
        "tags": [
          "Orders"
        ],
        "summary": "Create dedicated order",
        "description": "Creates a billing/provisioning order for the authenticated reseller user.\n\n**`ipMode: \"provider\"`:** You do **not** need `subnetId` for automatic assignment — the service can pick a free IPv4 from a subnet you own **at the same datacenter** as the product (`locationCode` on `GET /dedicated/list`, `location` on your ranges). Databarn (`TV-DB`) ranges cannot be used on NorthC (`TV-NC`) servers and the reverse. Pass **`subnetId`** and/or `selectedAssignableIp(s)` / `ipAssignments` only when you want explicit control. A range from the other site returns **400**. If auto-pick finds no free IPv4 at that site, the request fails until you choose a matching subnet and IPs (e.g. via `GET /ip-ranges/assignable`).\n\n**`ipMode: \"own\"`:** Keep the included Trivox IPv4 on the server (not a BYOIP range).\n\n**IPv4 add-ons:** `dedicatedIpv4AddonExtraIps` is any extra count from 0 to 63 at **2.50 EUR** each per month and overrides the pack. `dedicatedIpv4AddonSubnet` is only a shortcut: `/32` = 0 extras, `/30` = +3, `/29` = +7, `/28` = +15. Any other size is treated as `/32` and adds no extras. Addresses come from every Trivox range at that datacenter that still has free space.\n\n**IPv6 /64 add-ons:** Optional `dedicatedIpv6AddonExtraSubnets` (or total via `dedicatedIpv6AddonKey`) assigns extra **/64** prefixes from the site pool (Databarn or NorthC) at **1.50 €** each per month. Landing cart packages are 1/4/8/16; the API accepts any quantity up to 63 extras.\n\n**Negative balance (resellers):** If your user is a **reseller** and you enabled **negative balance** in the panel with a **EUR limit** and **allow for orders**, this order may be placed even when your wallet would drop **down to `−limit`** (not lower). Otherwise the account balance must cover the **full** order total; if not, you get an insufficient-balance style error (`409` / message depending on path). The limit and on/off state are configured per account in the customer/reseller panel.",
        "operationId": "createDedicatedOrder",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DedicatedOrderRequest"
              },
              "examples": {
                "providerAutoSubnet": {
                  "summary": "Provider IP — backend assigns (no subnet in body)",
                  "description": "Typical automation: only product, traffic option, and provider mode. Server picks first free owned IPv4.",
                  "value": {
                    "productId": 73,
                    "trafficUpgradeKey": "TRAFFIC_DEDI_3300",
                    "ipMode": "provider",
                    "autoRenew": false
                  }
                },
                "providerExplicitSubnet": {
                  "summary": "Provider IP — pinned subnet / explicit choice",
                  "description": "Use when you require a specific subnet or already chose IPs from `GET /ip-ranges/assignable`.",
                  "value": {
                    "productId": 73,
                    "trafficUpgradeKey": "TRAFFIC_DEDI_3300",
                    "ipMode": "provider",
                    "subnetId": 91,
                    "selectedAssignableIp": "203.0.113.10",
                    "autoRenew": false
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Order created (check `order` payload and messages).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "order": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                },
                "examples": {
                  "providerOrderCreated": {
                    "summary": "Provider IP order (example)",
                    "description": "Illustrative billing and `ipAssignment` shape; amounts and ids are fictional.",
                    "value": {
                      "success": true,
                      "order": {
                        "productId": 73,
                        "invoiceId": 10042,
                        "totalPrice": 499.99,
                        "upgrade": {
                          "key": "TRAFFIC_RESELLER_DEDI_3300",
                          "label": "3300",
                          "price": 299.99
                        },
                        "balanceBefore": 5000,
                        "balanceAfter": 4500.01,
                        "ipAssignment": {
                          "mode": "provider",
                          "selectedIp": "203.0.113.10",
                          "selectedIps": [
                            "203.0.113.10"
                          ],
                          "providerRequired": true,
                          "providerIpChosen": true,
                          "removedExisting": true,
                          "modified": true,
                          "addon": {
                            "subnet": "/32",
                            "extraIps": 0,
                            "assignedIps": [],
                            "allocation": []
                          },
                          "subnetId": 91
                        }
                      }
                    }
                  },
                  "providerAutoIp": {
                    "summary": "Provider IP — auto-picked (no subnetId in request)",
                    "value": {
                      "success": true,
                      "order": {
                        "productId": 73,
                        "invoiceId": 10043,
                        "totalPrice": 499.99,
                        "upgrade": {
                          "key": "TRAFFIC_RESELLER_DEDI_3300",
                          "label": "3300",
                          "price": 299.99
                        },
                        "balanceBefore": 4500.01,
                        "balanceAfter": 4000.02,
                        "ipAssignment": {
                          "mode": "provider",
                          "selectedIp": "203.0.113.18",
                          "selectedIps": [
                            "203.0.113.18"
                          ],
                          "providerRequired": true,
                          "providerIpChosen": true,
                          "removedExisting": true,
                          "modified": true,
                          "addon": {
                            "subnet": "/32",
                            "extraIps": 0,
                            "assignedIps": [],
                            "allocation": []
                          },
                          "subnetId": null
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Validation / business rule error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/servers": {
      "get": {
        "tags": [
          "Dedicated"
        ],
        "summary": "List your dedicated servers",
        "description": "Returns dedicated servers for the API key owner (`active`, `inactive`, `suspended`). Each item includes service fields and a nested `product` object with hardware specs (`processorFrequence`, `processorTurboFrequence`, RAM, storage, etc.).",
        "operationId": "listDedicatedServers",
        "responses": {
          "200": {
            "description": "Server list.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    }
                  }
                },
                "examples": {
                  "dedicatedServerList": {
                    "summary": "Two active servers (example)",
                    "description": "Illustrative subset of a multi-server account.",
                    "value": {
                      "success": true,
                      "data": [
                        {
                          "id": 101,
                          "name": "dedi-01.example.com",
                          "price": "0.00",
                          "expiresAt": "2026-12-01T12:00:00.000Z",
                          "createdAt": "2025-12-01T12:00:00.000Z",
                          "autoRenew": "True",
                          "emailExpiry": "True",
                          "maxTrafficTB": "330.00",
                          "trafficUsageTB": "41.50",
                          "powerStatus": "On",
                          "status": "Active",
                          "product": {
                            "hostname": "EXAMPLE-DB3-R640-101",
                            "processorBrand": "Intel Xeon",
                            "processor": "E5-2640v4",
                            "processorCores": 10,
                            "processorThreads": 20,
                            "processorCount": 1,
                            "processorFrequence": "2.40",
                            "processorTurboFrequence": "3.40",
                            "ramAmount": 64,
                            "ramType": "DDR4",
                            "storageFirst": "1TB",
                            "storageFirstType": "SSD",
                            "storageFirstAmount": 2,
                            "storageSecond": null,
                            "storageSecondType": null,
                            "storageSecondAmount": null,
                            "trafficTB": "330.00",
                            "raidLevels": "Automatic Partitioning",
                            "operatingSystems": "AlmaLinux,CentOS,Debian,Ubuntu",
                            "rescueSystems": "Clonezilla,GRML,Memtest,SystemRescueCD",
                            "status": "Unavailable"
                          }
                        },
                        {
                          "id": 102,
                          "name": "dedi-02.example.com",
                          "price": "0.00",
                          "expiresAt": "2028-06-15T08:00:00.000Z",
                          "createdAt": "2025-06-15T08:00:00.000Z",
                          "autoRenew": "True",
                          "emailExpiry": "True",
                          "maxTrafficTB": "3300.00",
                          "trafficUsageTB": "465.00",
                          "powerStatus": "On",
                          "status": "Active",
                          "product": {
                            "hostname": "EXAMPLE-DB1-R740-102",
                            "processorBrand": "Intel Xeon",
                            "processor": "Gold 6148",
                            "processorCores": 40,
                            "processorThreads": 80,
                            "processorCount": 2,
                            "processorFrequence": "2.40",
                            "processorTurboFrequence": "3.70",
                            "ramAmount": 512,
                            "ramType": "DDR4",
                            "storageFirst": "120GB",
                            "storageFirstType": "SSD",
                            "storageFirstAmount": 2,
                            "storageSecond": "4TB",
                            "storageSecondType": "NVMe",
                            "storageSecondAmount": 2,
                            "trafficTB": "330.00",
                            "raidLevels": "Automatic Partitioning,Install on smallest disk,Install on largest disk",
                            "operatingSystems": "AlmaLinux,CentOS,Debian,Ubuntu,Proxmox",
                            "rescueSystems": "Clonezilla,GRML,Memtest,SystemRescueCD",
                            "status": "Unavailable"
                          }
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/rename": {
      "patch": {
        "tags": [
          "Dedicated"
        ],
        "summary": "Rename dedicated server",
        "description": "Set the display name (3–22 characters).",
        "operationId": "renameDedicated",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 22,
                    "description": "New server name."
                  }
                }
              },
              "examples": {
                "rename": {
                  "summary": "Rename server",
                  "value": {
                    "name": "dedi-01.example.com"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Name updated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Name updated"
                    }
                  }
                },
                "examples": {
                  "renameSuccess": {
                    "summary": "Rename succeeded",
                    "value": {
                      "success": true,
                      "message": "Name updated"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Validation or guard failure",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/activity": {
      "get": {
        "tags": [
          "Console"
        ],
        "summary": "Dedicated activity",
        "description": "Lifecycle and management events for this dedicated server: panel actions (power, console, reinstall, SSH keys, traffic addons, notices) merged with provider activity (power/console/reinstall).",
        "operationId": "getDedicatedActivity",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "Activity list.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "activities": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "event": {
                                "type": "string",
                                "example": "Power"
                              },
                              "description": {
                                "type": "string",
                                "nullable": true,
                                "example": "Power on"
                              },
                              "timestamp": {
                                "type": "string",
                                "format": "date-time",
                                "nullable": true
                              },
                              "source": {
                                "type": "string",
                                "nullable": true,
                                "description": "`panel` for Trivox logs, `provider` for upstream activity.",
                                "example": "panel"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "activity": {
                    "summary": "Recent events",
                    "value": {
                      "success": true,
                      "data": {
                        "activities": [
                          {
                            "id": "action-12",
                            "event": "Console",
                            "description": "VNC console session started",
                            "timestamp": "2026-09-20T16:00:00.000Z",
                            "source": "panel"
                          },
                          {
                            "id": "tos-1812",
                            "event": "Power",
                            "description": "Executed Power Action setPowerOff",
                            "timestamp": "2026-09-20T15:56:21.000Z",
                            "source": "provider"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/vnc": {
      "get": {
        "tags": [
          "Console"
        ],
        "summary": "Get KVM / VNC console session",
        "description": "Starts a short-lived HTML5 console session, or **reuses** an existing non-expired session. Prefer **`data.wssUrl`** (and optional **`data.password`**). Sessions report **`data.autoDisableMinutes`** (default 60) and **`data.expiresAt`**. When a live session is reused, **`data.reused`** is `true` and the original expiry is kept. Pass **`forceNew=1`** or **`true`** (alias **`force=1`**) to skip reuse. The requester client IP is forwarded for console IP binding. An hourly job clears every tracked console session, not only ones past `expiresAt`.",
        "operationId": "getDedicatedVnc",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          },
          {
            "name": "forceNew",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "true"
              ]
            },
            "description": "When set, always start a fresh console session instead of reusing a tracked one."
          }
        ],
        "responses": {
          "200": {
            "description": "Console session issued.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "format": "uri",
                          "description": "Browser console page URL (compatibility; prefer wssUrl)."
                        },
                        "wssUrl": {
                          "type": "string",
                          "format": "uri",
                          "description": "WebSocket URL for an HTML5 noVNC / RFB client."
                        },
                        "password": {
                          "type": "string",
                          "nullable": true,
                          "description": "Optional VNC password for the WebSocket session."
                        },
                        "autoDisableMinutes": {
                          "type": "integer",
                          "nullable": true,
                          "example": 60,
                          "description": "Session lifetime in minutes before auto-disconnect."
                        },
                        "enabledAt": {
                          "type": "string",
                          "format": "date-time",
                          "description": "When this console session was started."
                        },
                        "expiresAt": {
                          "type": "string",
                          "format": "date-time",
                          "nullable": true,
                          "description": "When the session should be disconnected."
                        },
                        "reused": {
                          "type": "boolean",
                          "description": "True when an existing non-expired console session was returned instead of starting a new one."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "consoleSession": {
                    "summary": "HTML5 credentials with expiry",
                    "value": {
                      "success": true,
                      "data": {
                        "url": "https://ipmi.example.com/console/7f3a9c2e1b8d4f6a0e5c1d9b2a8f4e6c3d1b0a9f8",
                        "wssUrl": "wss://ipmi.example.com/console-socket/11465",
                        "password": "example-session-password",
                        "autoDisableMinutes": 60,
                        "enabledAt": "2026-09-20T15:00:00.000Z",
                        "expiresAt": "2026-09-20T16:00:00.000Z"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found or console unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Console"
        ],
        "summary": "Stop / clear KVM console session",
        "description": "Clears the tracked dedicated console session so the next `GET /dedicated/{id}/vnc` starts a fresh session. Clients should also close any open WebSocket/noVNC connection.",
        "operationId": "deleteDedicatedVnc",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "Session cleared.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "cleared": {
                          "type": "boolean",
                          "example": true
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "cleared": {
                    "summary": "Session cleared",
                    "value": {
                      "success": true,
                      "data": {
                        "cleared": true
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}": {
      "get": {
        "tags": [
          "Dedicated"
        ],
        "summary": "Dedicated detail",
        "description": "Returns `{ success, data }` with **`dedicated`** (your service row), **`product`** (hardware catalog and plan pricing; CPU includes `processorFrequence` and `processorTurboFrequence`), **`availableOs`** / **`availableRescue`** (reinstall options, including **`versions[].allowSshKeys`**), and **`server`** (live state: OS, IPs, traffic, console). Manage install keys with `GET/POST /dedicated/{id}/ssh-keys` and pass selected ids as **`sshKeys`** on reinstall.",
        "operationId": "getDedicatedDetail",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "Dedicated detail.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "dedicatedDetail": {
                    "summary": "Active server (example, OS lists truncated)",
                    "value": {
                      "success": true,
                      "data": {
                        "dedicated": {
                          "id": 101,
                          "name": "dedi-01.example.com",
                          "price": "0.00",
                          "expiresAt": "2026-12-01T12:00:00.000Z",
                          "createdAt": "2025-12-01T12:00:00.000Z",
                          "autoRenew": "True",
                          "emailExpiry": "True",
                          "maxTrafficTB": "330.00",
                          "trafficUsageTB": "41.50",
                          "powerStatus": "On",
                          "status": "Active"
                        },
                        "product": {
                          "id": 73,
                          "hostname": "EXAMPLE-DB3-BL460-101",
                          "price": "144.99",
                          "resellerPrice": "135.00",
                          "processorBrand": "Intel Xeon",
                          "processor": "E5-2640v4",
                          "processorCores": 10,
                          "processorThreads": 20,
                          "processorCount": 1,
                          "processorFrequence": "2.40",
                          "processorTurboFrequence": "3.40",
                          "ramAmount": 64,
                          "ramType": "DDR4",
                          "storageFirst": "1TB",
                          "storageFirstType": "SSD",
                          "storageFirstAmount": 2,
                          "storageSecond": null,
                          "storageSecondType": null,
                          "storageSecondAmount": null,
                          "portSpeed": "10 Gbit/s",
                          "trafficTB": "330.00",
                          "raidLevels": "Automatic Partitioning",
                          "operatingSystems": "AlmaLinux,CentOS,Debian,Ubuntu",
                          "rescueSystems": "Clonezilla,GRML,Memtest,SystemRescueCD",
                          "status": "Unavailable"
                        },
                        "availableOs": [
                          {
                            "category": "Debian",
                            "versions": [
                              {
                                "id": 28,
                                "name": "Debian 12",
                                "allowSshKeys": true
                              },
                              {
                                "id": 51,
                                "name": "Debian 13",
                                "allowSshKeys": true
                              }
                            ]
                          },
                          {
                            "category": "Ubuntu",
                            "versions": [
                              {
                                "id": 22,
                                "name": "Ubuntu 22.04",
                                "allowSshKeys": true
                              },
                              {
                                "id": 39,
                                "name": "Ubuntu 24.04",
                                "allowSshKeys": true
                              }
                            ]
                          }
                        ],
                        "availableRescue": [
                          {
                            "category": "System Rescue CD",
                            "versions": [
                              {
                                "id": 41,
                                "name": "System Rescue CD 11",
                                "allowSshKeys": true
                              }
                            ]
                          },
                          {
                            "category": "Memtest86+",
                            "versions": [
                              {
                                "id": 40,
                                "name": "Memtest86+ 7.00",
                                "allowSshKeys": false
                              }
                            ]
                          }
                        ],
                        "server": {
                          "result": {
                            "os": "Debian 12",
                            "primaryip": "203.0.113.10",
                            "consoleprovider": {
                              "type": "ipmi",
                              "supportedConsoleMode": "web+standard"
                            },
                            "trafficStatistics": {
                              "1d": "0.55",
                              "7d": "115.58",
                              "30d": "174.88",
                              "95th_total_30d": "0.37"
                            },
                            "lastBwrate": {
                              "in": "0.09",
                              "out": "0.05"
                            },
                            "isSuspended": 0,
                            "ipassignments": [
                              {
                                "ip": "203.0.113.10",
                                "primary_ip": 1,
                                "ipAttributes": {
                                  "isIpv4": 1,
                                  "isIpv6": 0,
                                  "isSubnet": 0
                                },
                                "subnetinformation": {
                                  "subnet": "203.0.113.0",
                                  "netmask": "255.255.255.0",
                                  "gw": "203.0.113.1",
                                  "type": "v4",
                                  "subnetOwnedByUser": true
                                }
                              },
                              {
                                "ip": "2001:db8:1234::/48",
                                "primary_ip": 0,
                                "ipAttributes": {
                                  "isIpv4": 0,
                                  "isIpv6": 1,
                                  "isSubnet": 1
                                },
                                "subnetinformation": {
                                  "subnet": "2001:db8:1234::",
                                  "gw": "2001:db8:1234::1",
                                  "type": "v6",
                                  "subnetOwnedByUser": false
                                }
                              }
                            ]
                          },
                          "message": "success"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/power/{action}": {
      "post": {
        "tags": [
          "Power"
        ],
        "summary": "Power action",
        "description": "State-changing command — use **POST** (not GET). Path **`action`**: **start**, **stop**, or **reboot** (case-insensitive). No request body required.",
        "operationId": "dedicatedPowerAction",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          },
          {
            "name": "action",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "start",
                "stop",
                "reboot"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Action accepted.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "action": {
                          "type": "string",
                          "enum": [
                            "start",
                            "stop",
                            "reboot"
                          ]
                        },
                        "powerStatus": {
                          "type": "string",
                          "description": "Updated local status after the command (e.g. On, Off, Maintenance, reinstallationRunning)."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "powerStart": {
                    "summary": "Start server",
                    "value": {
                      "success": true,
                      "data": {
                        "action": "start",
                        "powerStatus": "On"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid action or remote failure",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/power/status": {
      "get": {
        "tags": [
          "Power"
        ],
        "summary": "Power status",
        "description": "Read-only — use **GET**. Returns normalized **`powerStatus`** (`On`, `Off`, `Maintenance`, `reinstallationRunning`, …) plus optional TenantOS **`raw`** payload.",
        "operationId": "getDedicatedPowerStatus",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "Current power status.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "powerStatus": {
                          "type": "string"
                        },
                        "raw": {
                          "type": "object",
                          "additionalProperties": true
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "powerStatusOff": {
                    "summary": "Server offline",
                    "value": {
                      "success": true,
                      "data": {
                        "powerStatus": "Off",
                        "raw": {
                          "result": "offline",
                          "message": "success"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Could not read status",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/traffic": {
      "post": {
        "tags": [
          "Traffic"
        ],
        "summary": "Traffic statistics",
        "description": "JSON body with at least `predefined` window, or advanced fields (`groupBy`, `summary`, `statsMode`, `from`, `to`) as supported by the traffic service.",
        "operationId": "getDedicatedTraffic",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrafficRequestBody"
              },
              "example": {
                "predefined": "24h"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Traffic statistics (graph or text depending on request).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "trafficGraph24h": {
                    "summary": "24h graph (truncated)",
                    "description": "Example shows two samples; real responses include the full series for the selected window.",
                    "value": {
                      "success": true,
                      "data": {
                        "predefined": "24h",
                        "graph": {
                          "result": [
                            {
                              "name": "eth0",
                              "earliestDate": "2026-05-15 09:29:33",
                              "stats": [
                                {
                                  "time": "2026-05-15T09:30:05Z",
                                  "bwrate_total": 75456.05,
                                  "bwrate_out": 0,
                                  "bwrate_in": 75456.05,
                                  "traffic_out": 0,
                                  "traffic_in": 22636816,
                                  "traffic_total": 22636816
                                },
                                {
                                  "time": "2026-05-15T09:35:03Z",
                                  "bwrate_total": 74321.32,
                                  "bwrate_out": 0,
                                  "bwrate_in": 74321.32,
                                  "traffic_out": 0,
                                  "traffic_in": 22147752,
                                  "traffic_total": 22147752
                                }
                              ],
                              "features": {
                                "availablePredefinedValues": {
                                  "24h": {
                                    "lang": "24 Hours",
                                    "submitValue": "24h",
                                    "available": 1
                                  },
                                  "14days": {
                                    "lang": "14 Days",
                                    "submitValue": "14days",
                                    "available": 1
                                  },
                                  "30days": {
                                    "lang": "30 Days",
                                    "submitValue": "30days",
                                    "available": 1
                                  },
                                  "all": {
                                    "lang": "All",
                                    "submitValue": "all",
                                    "available": 1
                                  }
                                },
                                "customRangeAvailable": 1
                              },
                              "selectedPredefinedTimerange": "24h",
                              "from": "2026-05-15 09:29:33",
                              "to": "2026-05-15 23:59:59"
                            }
                          ],
                          "message": "success"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input or not eligible",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/rdns": {
      "get": {
        "tags": [
          "rDNS"
        ],
        "summary": "Get PTR for IP",
        "description": "Query **`ip`** must be assigned to **this** dedicated (`GET /dedicated/{id}` → `server.result.ipassignments`). Only **Trivox** IPv4 pools support rDNS via this API (not reseller BYOIP). **`ptr`** is `null` if no PTR exists yet.",
        "operationId": "getRdns",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          },
          {
            "name": "ip",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "ipv4"
            },
            "description": "IPv4 assigned to this dedicated (Trivox pool)."
          }
        ],
        "responses": {
          "200": {
            "description": "PTR record (or null).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "ip": {
                          "type": "string",
                          "format": "ipv4"
                        },
                        "ptr": {
                          "type": "string",
                          "nullable": true,
                          "description": "FQDN PTR target, or null."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "ptrSet": {
                    "summary": "PTR configured",
                    "value": {
                      "success": true,
                      "data": {
                        "ip": "203.0.113.10",
                        "ptr": "dedi-01.example.com"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing/invalid IP or IP not eligible",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Dedicated not found or IP not assigned to this server",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "rDNS"
        ],
        "summary": "Set PTR",
        "description": "Create or update PTR for an IPv4 on **this** dedicated (same ownership rules as `GET`). Send **`application/json`** with **`ip`** and **`ptr`** (FQDN).",
        "operationId": "setRdns",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ip",
                  "ptr"
                ],
                "properties": {
                  "ip": {
                    "type": "string",
                    "format": "ipv4"
                  },
                  "ptr": {
                    "type": "string",
                    "description": "FQDN hostname for PTR."
                  }
                }
              },
              "examples": {
                "setPtr": {
                  "summary": "Set PTR",
                  "value": {
                    "ip": "203.0.113.10",
                    "ptr": "dedi-02.example.com"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "PTR updated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "ip": {
                          "type": "string",
                          "format": "ipv4"
                        },
                        "ptr": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "setPtrSuccess": {
                    "summary": "PTR set",
                    "value": {
                      "success": true,
                      "data": {
                        "ip": "203.0.113.10",
                        "ptr": "dedi-02.example.com"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Validation error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Dedicated not found or IP not assigned to this server",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "rDNS"
        ],
        "summary": "Delete PTR",
        "description": "Remove PTR for an IPv4 on **this** dedicated. Body: **`ip`** only.",
        "operationId": "deleteRdns",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ip"
                ],
                "properties": {
                  "ip": {
                    "type": "string",
                    "format": "ipv4"
                  }
                }
              },
              "examples": {
                "deletePtr": {
                  "summary": "Delete PTR",
                  "value": {
                    "ip": "203.0.113.10"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "PTR removed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "ip": {
                          "type": "string",
                          "format": "ipv4"
                        },
                        "ptr": {
                          "type": "string",
                          "nullable": true
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "deletePtrSuccess": {
                    "summary": "PTR deleted",
                    "value": {
                      "success": true,
                      "data": {
                        "ip": "203.0.113.10",
                        "ptr": null
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Dedicated not found or IP not assigned to this server",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/reinstall": {
      "post": {
        "tags": [
          "OS / reinstall"
        ],
        "summary": "Start reinstall",
        "description": "Triggers OS/rescue reinstall on the dedicated. Send **`application/json`** with fields from `ReinstallRequest`. When **`raid`** and **`disklayoutId`** are both omitted, the layout is chosen from this server's supported `product.raidLevels` (single option; or **Install on smallest disk** when available among multiple; otherwise first supported in product order — never a hardcoded Automatic default). Optional **`sshKeys`** are ids from `GET /dedicated/{id}/ssh-keys` and are only accepted when the selected profile has **`allowSshKeys: true`**. On success, **`data.result`** echoes provisioning details (including **`rootpassword`** — lowercase in the response, separate from request **`rootPassword`**).",
        "operationId": "dedicatedReinstall",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReinstallRequest"
              },
              "examples": {
                "reinstallOs": {
                  "summary": "Reinstall with OS profile",
                  "value": {
                    "disklayoutId": 1,
                    "raid": "",
                    "profileId": 28,
                    "rootPassword": "your-secure-password",
                    "runScripts": [],
                    "sshKeys": [
                      13
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Reinstall started.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "result": {
                          "type": "object",
                          "properties": {
                            "rootpassword": {
                              "type": "string",
                              "description": "Root password echoed by TenantOS (response field name is lowercase)."
                            },
                            "oneTimeMethodCallback": {
                              "type": "string",
                              "nullable": true
                            },
                            "provisioningType": {
                              "type": "string",
                              "example": "reinstall"
                            },
                            "os": {
                              "type": "string",
                              "description": "Installed OS label."
                            }
                          }
                        },
                        "message": {
                          "type": "string",
                          "example": "success"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "reinstallStarted": {
                    "summary": "Reinstall accepted",
                    "value": {
                      "success": true,
                      "data": {
                        "result": {
                          "rootpassword": "your-secure-password",
                          "oneTimeMethodCallback": null,
                          "provisioningType": "reinstall",
                          "os": "Debian 12"
                        },
                        "message": "success"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/reinstall/abort": {
      "post": {
        "tags": [
          "OS / reinstall"
        ],
        "summary": "Abort reinstall",
        "description": "Body optional: `{ \"withoutPowerReset\": true }` (default **true**).",
        "operationId": "dedicatedReinstallAbort",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "withoutPowerReset": {
                    "type": "boolean",
                    "default": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Reinstall aborted.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "result": {
                          "type": "string",
                          "example": "ok"
                        },
                        "message": {
                          "type": "string",
                          "example": "success"
                        },
                        "powerStatus": {
                          "type": "string",
                          "description": "Server power status after abort (e.g. On, Off)."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "reinstallAborted": {
                    "summary": "Abort succeeded",
                    "value": {
                      "success": true,
                      "data": {
                        "result": "ok",
                        "message": "success",
                        "powerStatus": "Off"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/ssh-keys": {
      "get": {
        "tags": [
          "Dedicated",
          "OS / reinstall"
        ],
        "summary": "List SSH keys",
        "description": "SSH keys stored on your Trivox account for dedicated install/reinstall. Select ids here and pass them as **`sshKeys`** in `POST /dedicated/{id}/reinstall` when the OS profile has **`allowSshKeys: true`**.",
        "operationId": "listDedicatedSshKeysReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "SSH keys for this account.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "keys": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/DedicatedSshKey"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "sshKeyList": {
                    "summary": "One key",
                    "value": {
                      "success": true,
                      "data": {
                        "keys": [
                          {
                            "id": 13,
                            "name": "laptop",
                            "publicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOMqqnkVzrm0SdG6UOoqKLsabgH5C9okWi0dh2l9GKJl user@hostname",
                            "fingerprint": null,
                            "createdAt": "2026-08-22T21:18:48.000000Z"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Dedicated",
          "OS / reinstall"
        ],
        "summary": "Add SSH key",
        "description": "Stores an OpenSSH public key on your account (max 5). Name must be 3–16 characters.",
        "operationId": "addDedicatedSshKeyReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "publicKey"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 16
                  },
                  "publicKey": {
                    "type": "string",
                    "description": "OpenSSH public key line (`ssh-ed25519`, `ssh-rsa`, or `ecdsa-sha2-nistp*`)."
                  }
                }
              },
              "examples": {
                "addKey": {
                  "summary": "Add ed25519 key",
                  "value": {
                    "name": "laptop",
                    "publicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOMqqnkVzrm0SdG6UOoqKLsabgH5C9okWi0dh2l9GKJl user@hostname"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "SSH key created.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "key": {
                          "$ref": "#/components/schemas/DedicatedSshKey"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "sshKeyAdded": {
                    "summary": "Key created",
                    "value": {
                      "success": true,
                      "message": "SSH key added.",
                      "data": {
                        "key": {
                          "id": 13,
                          "name": "laptop",
                          "publicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOMqqnkVzrm0SdG6UOoqKLsabgH5C9okWi0dh2l9GKJl user@hostname",
                          "fingerprint": null,
                          "createdAt": "2026-08-22T21:18:48.000000Z"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/ssh-keys/{keyId}": {
      "delete": {
        "tags": [
          "Dedicated",
          "OS / reinstall"
        ],
        "summary": "Delete SSH key",
        "operationId": "deleteDedicatedSshKeyReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          },
          {
            "name": "keyId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "SSH key deleted.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "sshKeyDeleted": {
                    "summary": "Deleted",
                    "value": {
                      "success": true,
                      "message": "SSH key deleted."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/ips/description": {
      "get": {
        "tags": [
          "Dedicated"
        ],
        "summary": "Get IP description",
        "description": "Returns the description/comment for an IPv4 assigned to this dedicated.",
        "operationId": "getDedicatedIpDescriptionReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          },
          {
            "name": "ip",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "ipv4"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "IP description.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "desc": {
                    "summary": "Current description",
                    "value": {
                      "success": true,
                      "data": {
                        "ip": "203.0.113.10",
                        "description": "web-01"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": [
          "Dedicated"
        ],
        "summary": "Update IP description",
        "description": "Sets the description/comment on an IPv4 assigned to this dedicated.",
        "operationId": "updateDedicatedIpDescriptionReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ip"
                ],
                "properties": {
                  "ip": {
                    "type": "string",
                    "format": "ipv4"
                  },
                  "description": {
                    "type": "string"
                  }
                }
              },
              "examples": {
                "setDesc": {
                  "summary": "Set label",
                  "value": {
                    "ip": "203.0.113.10",
                    "description": "web-01"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Description updated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/ips/primary": {
      "post": {
        "tags": [
          "Dedicated"
        ],
        "summary": "Set primary IPv4",
        "description": "Marks an already assigned IPv4 as the primary address for this dedicated.",
        "operationId": "setDedicatedPrimaryIpReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ip"
                ],
                "properties": {
                  "ip": {
                    "type": "string",
                    "format": "ipv4"
                  }
                }
              },
              "examples": {
                "setPrimary": {
                  "summary": "Primary IP",
                  "value": {
                    "ip": "203.0.113.10"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Primary IP set.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "ok": {
                    "summary": "Primary",
                    "value": {
                      "success": true,
                      "data": {
                        "ip": "203.0.113.10",
                        "primary": true
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/billing/auto-renew": {
      "post": {
        "tags": [
          "Billing"
        ],
        "summary": "Set auto-renew",
        "operationId": "setBillingAutoRenew",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "enable"
                ],
                "properties": {
                  "enable": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Auto-renew updated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "autoRenewEnabled": {
                    "summary": "Auto-renew enabled",
                    "value": {
                      "success": true,
                      "message": "Auto-renew enabled"
                    }
                  },
                  "autoRenewDisabled": {
                    "summary": "Auto-renew disabled",
                    "value": {
                      "success": true,
                      "message": "Auto-renew disabled"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/billing/email-notify": {
      "post": {
        "tags": [
          "Billing"
        ],
        "summary": "Expiry email notifications",
        "operationId": "setBillingEmailNotify",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "enable"
                ],
                "properties": {
                  "enable": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Expiry email notification preference updated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "emailNotifyEnabled": {
                    "summary": "Notifications enabled",
                    "value": {
                      "success": true,
                      "message": "Expiry email notifications enabled"
                    }
                  },
                  "emailNotifyDisabled": {
                    "summary": "Notifications disabled",
                    "value": {
                      "success": true,
                      "message": "Expiry email notifications disabled"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/billing/renew/options": {
      "get": {
        "tags": [
          "Billing"
        ],
        "summary": "Renewal price options",
        "description": "Returns renewal **months** and **prices** for this dedicated server. Use the chosen `months` with **`POST .../billing/renew`**. **Negative balance** does not change these amounts; it only affects whether a charge is allowed when your balance is low (see renew endpoint).",
        "operationId": "getBillingRenewOptions",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "Renewal pricing for this dedicated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "monthly": {
                          "type": "number",
                          "description": "Base monthly renewal price (EUR)."
                        },
                        "options": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "months": {
                                "type": "integer",
                                "enum": [
                                  1,
                                  3,
                                  6,
                                  12
                                ]
                              },
                              "monthly": {
                                "type": "number"
                              },
                              "discount": {
                                "type": "number",
                                "description": "Fractional discount (e.g. 0.05 = 5%)."
                              },
                              "gross": {
                                "type": "number",
                                "description": "Price before discount (monthly × months)."
                              },
                              "total": {
                                "type": "number",
                                "description": "Amount charged for this term (EUR)."
                              }
                            }
                          }
                        },
                        "balance": {
                          "type": "number",
                          "description": "Current wallet balance (EUR)."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "renewOptions": {
                    "summary": "Renewal tiers",
                    "value": {
                      "success": true,
                      "data": {
                        "monthly": 200,
                        "options": [
                          {
                            "months": 1,
                            "monthly": 200,
                            "discount": 0,
                            "gross": 200,
                            "total": 200
                          },
                          {
                            "months": 3,
                            "monthly": 200,
                            "discount": 0.05,
                            "gross": 600,
                            "total": 570
                          },
                          {
                            "months": 6,
                            "monthly": 200,
                            "discount": 0.1,
                            "gross": 1200,
                            "total": 1080
                          },
                          {
                            "months": 12,
                            "monthly": 200,
                            "discount": 0.2,
                            "gross": 2400,
                            "total": 1920
                          }
                        ],
                        "balance": 3532.56
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Not available",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/billing/renew": {
      "post": {
        "tags": [
          "Billing"
        ],
        "summary": "Perform renewal",
        "description": "`months` must be one of **1**, **3**, **6**, **12**.\n\n**Negative balance:** This call charges the renewal total to your wallet. If panel **negative balance** is enabled with **allow for dedicated server renews** (or dedicated auto-renews) and a **EUR limit**, the wallet may go down to **`−limit`**. **Platform auto-renew** (service auto-renew on) uses that same limit when **orders**, **dedicated renews**, or **auto-renews** is allowed. VPS renewals use their own VPS toggles (see **`POST /vps/{id}/billing/renew`**).",
        "operationId": "performBillingRenew",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "months"
                ],
                "properties": {
                  "months": {
                    "type": "integer",
                    "enum": [
                      1,
                      3,
                      6,
                      12
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Renewal completed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Renewal successful."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "months": {
                          "type": "integer",
                          "enum": [
                            1,
                            3,
                            6,
                            12
                          ]
                        },
                        "total": {
                          "type": "number",
                          "description": "Amount charged (EUR)."
                        },
                        "newExpiry": {
                          "type": "string",
                          "description": "New service expiry (`YYYY-MM-DD HH:mm:ss`)."
                        },
                        "invoiceId": {
                          "type": "integer"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "renewSuccess": {
                    "summary": "1-month renewal",
                    "value": {
                      "success": true,
                      "message": "Renewal successful.",
                      "data": {
                        "months": 1,
                        "total": 200,
                        "newExpiry": "2026-07-14 07:30:17",
                        "invoiceId": 926
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid months or billing error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/billing/traffic-addon/options": {
      "get": {
        "tags": [
          "Billing"
        ],
        "summary": "Dedicated traffic add-on options",
        "description": "**Recurring tiers (this route):** **`TRAFFIC_RESELLER_DEDI_*`** price then **`TRAFFIC_DEDI_*`**, option **`key`** = `TRAFFIC_RESELLER_DEDI_*` (Reseller API / API-manager context). Customer panel and **`GET /api/dedicateProducts`** (landing) use **only** `TRAFFIC_DEDI_*` keys and prices so displayed totals match checkout. Response includes **`trafficPricingSource`** (`public` or `reseller`). **One-time** add-ons: fixed per-TB `oneTimePricePerTB`.\n\n**Recurring tiers are absolute:** only tiers with **`totalIncludedTb` greater than the service’s current limit** are returned. Buying a tier **sets** the traffic limit to that total (not additive stacking). **`price`** / **`dueNow`** are the **monthly delta** vs the credit of the highest tier already reached (`listPrice` is the full catalog tier price; `creditApplied` is the credit).\n\n**Mid-cycle proration:** wallet charge is `price × daysRemaining / 30` (flat 30-day month, min 1 day; prepaid multi-month remaining scales above 1×). Top-level **`proration`** repeats `daysRemaining`, `daysPerMonth` (30), and `expiresAt`.",
        "operationId": "getDedicatedTrafficAddonOptions",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "Traffic add-on catalog for this dedicated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "trafficPricingSource": {
                          "type": "string",
                          "enum": [
                            "reseller",
                            "public"
                          ]
                        },
                        "minIncludedTrafficTB": {
                          "type": "number"
                        },
                        "currentTrafficLimitTB": {
                          "type": "number"
                        },
                        "oneTimePoolRemainingTB": {
                          "type": "number"
                        },
                        "effectiveTrafficLimitTB": {
                          "type": "number"
                        },
                        "currentMonthlyPrice": {
                          "type": "number"
                        },
                        "oneTimePricePerTB": {
                          "type": "number"
                        },
                        "proration": {
                          "type": "object",
                          "properties": {
                            "daysRemaining": {
                              "type": "integer",
                              "description": "Billable days left until renewal (ceil; minimum 1 when charging)."
                            },
                            "daysPerMonth": {
                              "type": "integer",
                              "example": 30
                            },
                            "expiresAt": {
                              "type": "string",
                              "format": "date-time",
                              "nullable": true
                            }
                          }
                        },
                        "recurringAddons": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string",
                                "description": "Pass as `upgradeKey` when purchasing recurring add-ons."
                              },
                              "tbAmount": {
                                "type": "number"
                              },
                              "totalIncludedTb": {
                                "type": "number"
                              },
                              "price": {
                                "type": "number",
                                "description": "Monthly renewal price delta vs current tier credit (EUR)."
                              },
                              "listPrice": {
                                "type": "number",
                                "description": "Full catalog monthly price for this absolute tier."
                              },
                              "creditApplied": {
                                "type": "number",
                                "description": "Monthly credit from the highest tier already reached."
                              },
                              "dueNow": {
                                "type": "number",
                                "description": "Wallet charge now (prorated from `price`)."
                              },
                              "daysRemaining": {
                                "type": "integer"
                              },
                              "pricePerTB": {
                                "type": "number"
                              }
                            }
                          }
                        },
                        "balance": {
                          "type": "number"
                        },
                        "limits": {
                          "type": "object",
                          "properties": {
                            "minTb": {
                              "type": "integer"
                            }
                          }
                        },
                        "negativeBalanceAvailable": {
                          "type": "number",
                          "example": 0,
                          "description": "EUR your wallet may go below 0 for this charge type (reseller negative balance). `0` when not enabled, not a reseller, or blocked by unpaid minus past the due window. A charge succeeds when `balance + negativeBalanceAvailable >= total`."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "trafficAddonOptions": {
                    "summary": "Reseller recurring tiers",
                    "value": {
                      "success": true,
                      "data": {
                        "trafficPricingSource": "reseller",
                        "minIncludedTrafficTB": 330,
                        "currentTrafficLimitTB": 330,
                        "oneTimePoolRemainingTB": 0,
                        "effectiveTrafficLimitTB": 330,
                        "currentMonthlyPrice": 200,
                        "oneTimePricePerTB": 1,
                        "proration": {
                          "daysRemaining": 5,
                          "daysPerMonth": 30,
                          "expiresAt": "2026-11-05T12:00:00.000Z"
                        },
                        "recurringAddons": [
                          {
                            "key": "TRAFFIC_RESELLER_DEDI_990",
                            "tbAmount": 660,
                            "totalIncludedTb": 990,
                            "listPrice": 99.99,
                            "creditApplied": 0,
                            "price": 99.99,
                            "dueNow": 16.67,
                            "daysRemaining": 5,
                            "pricePerTB": 0.15
                          },
                          {
                            "key": "TRAFFIC_RESELLER_DEDI_1650",
                            "tbAmount": 1320,
                            "totalIncludedTb": 1650,
                            "listPrice": 199.99,
                            "creditApplied": 0,
                            "price": 199.99,
                            "dueNow": 33.33,
                            "daysRemaining": 5,
                            "pricePerTB": 0.15
                          },
                          {
                            "key": "TRAFFIC_RESELLER_DEDI_3300",
                            "tbAmount": 2970,
                            "totalIncludedTb": 3300,
                            "listPrice": 299.99,
                            "creditApplied": 0,
                            "price": 299.99,
                            "dueNow": 50,
                            "daysRemaining": 5,
                            "pricePerTB": 0.1
                          }
                        ],
                        "balance": 3332.56,
                        "limits": {
                          "minTb": 1
                        },
                        "negativeBalanceAvailable": 0
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Not available",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/billing/traffic-addon/purchase": {
      "post": {
        "tags": [
          "Billing"
        ],
        "summary": "Purchase dedicated traffic add-on",
        "description": "Charges your wallet and applies the add-on. Call **`GET .../traffic-addon/options`** first.\n\n**`mode`** (required): **`recurring`** or **`one_time`**.\n\n- **`recurring`**: set **`upgradeKey`** to an entry from **`data.recurringAddons[].key`** (e.g. `TRAFFIC_RESELLER_DEDI_990`). **`tbAmount`** is ignored. Sets traffic limit to the tier’s **`totalIncludedTb`**. Wallet is charged prorated **`dueNow`** for the monthly **delta** (`price`); service monthly price rises by that same delta. Prior active recurring traffic add-on rows for the service are cancelled and replaced. Rejected if the service is already at/above that tier.\n- **`one_time`**: set **`tbAmount`** to an integer ≥ **`data.limits.minTb`** (usually **1**). Billed at **`data.oneTimePricePerTB`** EUR/TB. Do not send **`upgradeKey`**. Does not change monthly price.\n\nRequires sufficient **`balance`** for the immediate charge (`dueNow` / one-time total). **Negative balance (resellers):** with **allow for dedicated traffic addons** and a **EUR limit** enabled, the wallet may go down to **`−limit`** (see **`negativeBalanceAvailable`** on options).",
        "operationId": "purchaseDedicatedTrafficAddon",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "mode"
                ],
                "properties": {
                  "mode": {
                    "type": "string",
                    "enum": [
                      "recurring",
                      "one_time"
                    ],
                    "description": "Recurring monthly traffic tier upgrade, or one-time TB pool."
                  },
                  "upgradeKey": {
                    "type": "string",
                    "description": "Required when `mode` is `recurring`. Must match `recurringAddons[].key` from options."
                  },
                  "tbAmount": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "Required when `mode` is `one_time`. Integer TB to buy at `oneTimePricePerTB`."
                  }
                }
              },
              "examples": {
                "recurringPurchase": {
                  "summary": "Recurring tier (from options)",
                  "value": {
                    "mode": "recurring",
                    "upgradeKey": "TRAFFIC_RESELLER_DEDI_990"
                  }
                },
                "oneTimePurchase": {
                  "summary": "One-time TB pool",
                  "value": {
                    "mode": "one_time",
                    "tbAmount": 5
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Traffic add-on purchased.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Traffic addon purchased successfully."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "trafficPricingSource": {
                          "type": "string",
                          "enum": [
                            "reseller",
                            "public"
                          ]
                        },
                        "mode": {
                          "type": "string",
                          "enum": [
                            "recurring",
                            "one_time"
                          ]
                        },
                        "tbAmount": {
                          "type": "number"
                        },
                        "upgradeKey": {
                          "type": "string",
                          "nullable": true
                        },
                        "pricePerTB": {
                          "type": "number"
                        },
                        "total": {
                          "type": "number",
                          "description": "Amount charged to the wallet now (prorated for recurring)."
                        },
                        "monthlyAmount": {
                          "type": "number",
                          "description": "Full monthly delta added to service renewal price (recurring only; 0 for one-time)."
                        },
                        "proration": {
                          "type": "object",
                          "nullable": true,
                          "properties": {
                            "daysRemaining": {
                              "type": "integer"
                            },
                            "daysPerMonth": {
                              "type": "integer"
                            },
                            "expiresAt": {
                              "type": "string",
                              "format": "date-time",
                              "nullable": true
                            },
                            "monthlyAmount": {
                              "type": "number"
                            },
                            "dueNow": {
                              "type": "number"
                            }
                          }
                        },
                        "invoiceId": {
                          "type": "integer",
                          "nullable": true
                        },
                        "currentTrafficLimitTB": {
                          "type": "number"
                        },
                        "oneTimePoolRemainingTB": {
                          "type": "number"
                        },
                        "oneTimePoolPurchasedTB": {
                          "type": "number"
                        },
                        "effectiveTrafficLimitTB": {
                          "type": "number"
                        },
                        "currentMonthlyPrice": {
                          "type": "number"
                        },
                        "balance": {
                          "type": "number"
                        },
                        "unsuspendedAfterTrafficAddon": {
                          "type": "boolean"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "trafficAddonPurchased": {
                    "summary": "Recurring tier purchased",
                    "value": {
                      "success": true,
                      "message": "Traffic addon purchased successfully.",
                      "data": {
                        "trafficPricingSource": "reseller",
                        "mode": "recurring",
                        "tbAmount": 660,
                        "upgradeKey": "TRAFFIC_RESELLER_DEDI_990",
                        "pricePerTB": 0.15,
                        "total": 16.67,
                        "monthlyAmount": 99.99,
                        "proration": {
                          "daysRemaining": 5,
                          "daysPerMonth": 30,
                          "expiresAt": "2026-11-05T12:00:00.000Z",
                          "monthlyAmount": 99.99,
                          "dueNow": 16.67
                        },
                        "invoiceId": 927,
                        "currentTrafficLimitTB": 990,
                        "oneTimePoolRemainingTB": 0,
                        "oneTimePoolPurchasedTB": 0,
                        "effectiveTrafficLimitTB": 990,
                        "currentMonthlyPrice": 299.99,
                        "balance": 3315.89,
                        "unsuspendedAfterTrafficAddon": false
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/billing/traffic-addon/history": {
      "get": {
        "tags": [
          "Billing"
        ],
        "summary": "Dedicated traffic add-on history",
        "operationId": "getDedicatedTrafficAddonHistory",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "Traffic add-on purchase history and one-time pool usage.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "oneTimePoolRemainingTB": {
                          "type": "number"
                        },
                        "oneTimePoolPurchasedTB": {
                          "type": "number"
                        },
                        "oneTimePoolConsumedTB": {
                          "type": "number"
                        },
                        "history": {
                          "type": "object",
                          "properties": {
                            "addons": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "integer"
                                  },
                                  "mode": {
                                    "type": "string",
                                    "enum": [
                                      "recurring",
                                      "one_time"
                                    ]
                                  },
                                  "status": {
                                    "type": "string"
                                  },
                                  "totalTb": {
                                    "type": "number"
                                  },
                                  "remainingTb": {
                                    "type": "number",
                                    "nullable": true
                                  },
                                  "consumedTb": {
                                    "type": "number",
                                    "nullable": true
                                  },
                                  "pricePerTb": {
                                    "type": "number"
                                  },
                                  "totalPrice": {
                                    "type": "number"
                                  },
                                  "recurringMonthlyDelta": {
                                    "type": "number",
                                    "nullable": true
                                  },
                                  "invoiceId": {
                                    "type": "integer",
                                    "nullable": true
                                  },
                                  "createdAt": {
                                    "type": "string",
                                    "format": "date-time"
                                  },
                                  "updatedAt": {
                                    "type": "string",
                                    "format": "date-time"
                                  }
                                }
                              }
                            },
                            "consumption": {
                              "type": "array",
                              "items": {
                                "type": "object"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "trafficAddonHistory": {
                    "summary": "Recurring add-on on file",
                    "value": {
                      "success": true,
                      "data": {
                        "oneTimePoolRemainingTB": 0,
                        "oneTimePoolPurchasedTB": 0,
                        "oneTimePoolConsumedTB": 0,
                        "history": {
                          "addons": [
                            {
                              "id": 37,
                              "mode": "recurring",
                              "status": "active",
                              "totalTb": 660,
                              "remainingTb": null,
                              "consumedTb": null,
                              "pricePerTb": 0.15,
                              "totalPrice": 99.99,
                              "recurringMonthlyDelta": 99.99,
                              "invoiceId": 927,
                              "createdAt": "2026-05-15T07:59:30.000Z",
                              "updatedAt": "2026-05-15T07:59:30.000Z"
                            }
                          ],
                          "consumption": []
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/billing/traffic-addon/auto-expand": {
      "get": {
        "tags": [
          "Billing"
        ],
        "summary": "Get dedicated traffic auto-expand settings",
        "description": "Returns auto-expand settings for this dedicated server. When **enabled**, a one-time traffic top-up of **`tbAmount`** TB is purchased automatically once usage reaches **`triggerPercent`** (default **95%**) of the effective traffic limit. Default is **disabled**. **`maxPrice`** is an optional cumulative EUR budget since last reset (`null` = no cap).",
        "operationId": "getDedicatedTrafficAutoExpand",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "Current auto-expand settings.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/TrafficAutoExpandSettings"
                    }
                  }
                },
                "examples": {
                  "disabledDefault": {
                    "summary": "Disabled by default",
                    "value": {
                      "success": true,
                      "data": {
                        "enabled": false,
                        "tbAmount": 1,
                        "maxPrice": null,
                        "spentAmount": 0,
                        "remainingBudget": null,
                        "triggerPercent": 95,
                        "minTb": 1,
                        "maxTb": 100,
                        "pricePerTB": 1,
                        "exists": false
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": [
          "Billing"
        ],
        "summary": "Update dedicated traffic auto-expand settings",
        "description": "Enable/disable auto-expand and configure TB amount plus optional cumulative spending limit. Saving settings does **not** reset **`spentAmount`** — use **`POST .../auto-expand/reset-spent`** for that.",
        "operationId": "updateDedicatedTrafficAutoExpand",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrafficAutoExpandUpdateRequest"
              },
              "examples": {
                "enableWithBudget": {
                  "summary": "Enable 5 TB auto-buy with €50 budget",
                  "value": {
                    "enabled": true,
                    "tbAmount": 5,
                    "maxPrice": 50
                  }
                },
                "disable": {
                  "summary": "Disable auto-expand",
                  "value": {
                    "enabled": false,
                    "tbAmount": 1,
                    "maxPrice": null
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Settings saved.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Auto-expand settings saved."
                    },
                    "data": {
                      "$ref": "#/components/schemas/TrafficAutoExpandSettings"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/billing/traffic-addon/auto-expand/reset-spent": {
      "post": {
        "tags": [
          "Billing"
        ],
        "summary": "Reset dedicated auto-expand spending counter",
        "description": "Sets **`spentAmount`** back to **0** for this dedicated server so a configured **`maxPrice`** budget can be reused.",
        "operationId": "resetDedicatedTrafficAutoExpandSpent",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "Spending counter reset.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Auto-expand spending counter reset."
                    },
                    "data": {
                      "$ref": "#/components/schemas/TrafficAutoExpandSettings"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/ips": {
      "post": {
        "tags": [
          "Dedicated"
        ],
        "summary": "Assign IPs or purchase Trivox IPv4 addons",
        "description": "**Trivox pool quantity:** send `{ \"quantity\": N }` without `subnetId` to buy any count from 1 to 64 extra IPv4 `/32` addresses (2.50 EUR each/mo). Allocation walks every Trivox range at the server's datacenter and uses only addresses that range still has free. `/30`, `/29`, and `/28` are only order-time shortcuts for how many `/32`s to add.\n\n**Own range:** `subnetId` plus `ip`/`ips`. IPv4 assignments are `/32`. VPS IPv6 is `/64`. Dedicated products include IPv6 as `subnetSizeIPv6` (`/48` on the catalog); extra dedicated IPv6 add-ons are `/64`. Default `removeExisting: true`.",
        "operationId": "addDedicatedIps",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "subnetId": {
                    "type": "integer"
                  },
                  "ip": {
                    "type": "string",
                    "description": "Comma-separated IPv4/IPv6 list (IPv6 may include CIDR prefix)."
                  },
                  "ips": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "IPv4 addresses, IPv6 addresses, or IPv6 CIDR prefixes."
                  },
                  "removeExisting": {
                    "type": "boolean",
                    "default": true
                  },
                  "quantity": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 64,
                    "description": "Trivox pool purchase quantity (no subnetId)."
                  }
                }
              },
              "examples": {
                "assignOneIpv4": {
                  "summary": "Add one IPv4 (keep existing assignments)",
                  "value": {
                    "subnetId": 91,
                    "ips": [
                      "203.0.113.14"
                    ],
                    "removeExisting": false
                  }
                },
                "assignIpv6Prefix": {
                  "summary": "Add one IPv6 /64 prefix",
                  "value": {
                    "subnetId": 120,
                    "ips": [
                      "2a14:c380:20:8f::/64"
                    ],
                    "removeExisting": false
                  }
                },
                "trivoxQuantity": {
                  "summary": "Purchase 2 Trivox IPv4 addons",
                  "value": {
                    "quantity": 2
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "IPs assigned.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "assignSuccess": {
                    "summary": "Assignment succeeded",
                    "value": {
                      "success": true,
                      "data": {
                        "result": {
                          "ipAssignments": [
                            {
                              "updated_at": "2026-05-15T12:00:00.000000Z",
                              "ip": "203.0.113.14",
                              "primary_ip": 0,
                              "ipAttributes": {
                                "isIpv4": 1,
                                "isIpv6": 0,
                                "isSubnet": 0
                              },
                              "subnetinformation": {
                                "subnet": "203.0.113.0",
                                "cidr": 24,
                                "netmask": "255.255.255.0",
                                "gw": "203.0.113.1",
                                "type": "v4"
                              }
                            }
                          ],
                          "executedIpAssignment": true
                        },
                        "message": "success"
                      },
                      "submitted": [
                        "203.0.113.14"
                      ],
                      "removed": [],
                      "replacedExisting": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Validation error (missing/empty/invalid IPs)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Dedicated not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Dedicated"
        ],
        "summary": "Remove one IP assignment",
        "operationId": "removeDedicatedIp",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ip"
                ],
                "properties": {
                  "ip": {
                    "type": "string",
                    "description": "IPv4/IPv6 address or IPv6 CIDR prefix to unassign from the server."
                  }
                }
              },
              "examples": {
                "removeOneIpv4": {
                  "summary": "Remove one IPv4",
                  "value": {
                    "ip": "203.0.113.14"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "IP removed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "removeSuccess": {
                    "summary": "Deletion succeeded",
                    "value": {
                      "success": true,
                      "data": {
                        "message": "success",
                        "result": {
                          "executedIpDeletion": true
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid ip",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Dedicated not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "description": "Remove an assigned IP. When the address is a billable Trivox IPv4 or IPv6 addon, monthly price is reduced accordingly."
      }
    },
    "/vps/list": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "List VPS plans",
        "description": "Available `productKvm` plans. **`price`** is the public monthly list price (no separate reseller price).",
        "operationId": "listVpsPlans",
        "security": [],
        "responses": {
          "200": {
            "description": "Plan rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "name": {
                            "type": "string"
                          },
                          "cores": {
                            "type": "integer"
                          },
                          "ram": {
                            "type": "integer"
                          },
                          "storage": {
                            "type": "string"
                          },
                          "portSpeed": {
                            "type": "string"
                          },
                          "price": {
                            "type": "string"
                          },
                          "trafficTB": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "vpsPlans": {
                    "summary": "Available KVM plans",
                    "value": {
                      "success": true,
                      "data": [
                        {
                          "id": 1,
                          "name": "KVM-1",
                          "cores": 1,
                          "ram": 2,
                          "storage": "10 GB NVMe",
                          "portSpeed": "1 Gbit/s",
                          "price": "3.99",
                          "ipv6Amount": 1,
                          "ipv4Amount": 1,
                          "subnetSizeIPV4": "/32",
                          "subnetSizeIPv6": "/64",
                          "trafficTB": "10.00",
                          "status": "Available"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/order": {
      "post": {
        "tags": [
          "VPS"
        ],
        "summary": "Order VPS",
        "description": "Charges **`productKvm.price`** × `durationMonths` (no reseller discount parameter is applied). Optional extra IPv4 via `vpsIpv4AddonExtraIps` only (`vpsIpv4AddonSubnet` does not select a `/30` `/29` `/28` pack) and any quantity of extra IPv6 /64 (`vpsIpv6AddonExtraSubnets` or total via `vpsIpv6AddonKey`) at order time from the provider pool.\n\n**Negative balance (resellers):** If your user is a **reseller** with panel **negative balance** enabled, a **EUR limit** and **allow for VPS orders**, the order may be placed even when your wallet would drop **down to `−limit`** (not lower). Otherwise the balance must cover the full total; if not, you get **`409`** `Insufficient balance`.",
        "operationId": "createVpsResellerOrder",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "productId"
                ],
                "properties": {
                  "productId": {
                    "type": "integer"
                  },
                  "durationMonths": {
                    "type": "integer",
                    "minimum": 1,
                    "default": 1
                  },
                  "months": {
                    "type": "integer",
                    "description": "Alias of `durationMonths`."
                  },
                  "vpsIpv4AddonSubnet": {
                    "type": "string",
                    "default": "/32",
                    "description": "Stored label only. Unlike dedicated order, this does not add addresses. Set `vpsIpv4AddonExtraIps` for the extra IPv4 count."
                  },
                  "vpsIpv4AddonExtraIps": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "ipv4AddonExtraIps": {
                    "type": "integer",
                    "description": "Alias of `vpsIpv4AddonExtraIps`."
                  },
                  "vpsIpv6AddonKey": {
                    "type": "string",
                    "default": "1",
                    "description": "Total IPv6 /64 count including the one included with the plan (any integer >= 1, max 64). Example: `5` = 4 extras at 1.50 € each per month. Prefer `vpsIpv6AddonExtraSubnets` when you already know extras."
                  },
                  "vpsIpv6AddonExtraSubnets": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 63,
                    "description": "Extra /64 count beyond the included one. Any non-negative integer (billed at 1.50 € each per month). Overrides derivation from `vpsIpv6AddonKey` when set."
                  },
                  "ipv6AddonExtraSubnets": {
                    "type": "integer",
                    "description": "Alias of `vpsIpv6AddonExtraSubnets`."
                  },
                  "ipv6AddonKey": {
                    "type": "string",
                    "description": "Alias of `vpsIpv6AddonKey`."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Order placed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "order": {
                      "type": "object",
                      "properties": {
                        "productId": {
                          "type": "integer"
                        },
                        "serviceId": {
                          "type": "integer",
                          "description": "VPS service id (`virtualServerKvm.id`)."
                        },
                        "invoiceId": {
                          "type": "integer"
                        },
                        "totalPrice": {
                          "type": "number"
                        },
                        "durationMonths": {
                          "type": "integer"
                        },
                        "trafficLimitTb": {
                          "type": "number"
                        },
                        "vpsIpv4AddonSubnet": {
                          "type": "string"
                        },
                        "vpsIpv4AddonExtraIps": {
                          "type": "integer"
                        },
                        "vpsIpv6AddonKey": {
                          "type": "string",
                          "description": "Total /64 count requested at order time."
                        },
                        "vpsIpv6AddonExtraSubnets": {
                          "type": "integer"
                        },
                        "balanceBefore": {
                          "type": "number"
                        },
                        "balanceAfter": {
                          "type": "number"
                        },
                        "hostname": {
                          "type": "string",
                          "nullable": true,
                          "description": "Service hostname assigned at order time."
                        },
                        "ipv4Address": {
                          "type": "string",
                          "nullable": true,
                          "description": "Primary IPv4 (comma-separated when multiple)."
                        },
                        "ipv6Address": {
                          "type": "string",
                          "nullable": true,
                          "description": "Primary IPv6."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "vpsOrderSuccess": {
                    "summary": "New KVM-1 order",
                    "value": {
                      "success": true,
                      "order": {
                        "productId": 1,
                        "serviceId": 188,
                        "invoiceId": 928,
                        "totalPrice": 3.99,
                        "durationMonths": 1,
                        "discountApplied": null,
                        "trafficLimitTb": 10,
                        "vpsIpv4AddonSubnet": "/32",
                        "vpsIpv4AddonExtraIps": 0,
                        "vpsIpv6AddonKey": "1",
                        "vpsIpv6AddonExtraSubnets": 0,
                        "balanceBefore": 3232.57,
                        "balanceAfter": 3228.58,
                        "hostname": "trivox.sh",
                        "ipv4Address": "203.0.113.10",
                        "ipv6Address": "2001:db8::10"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict (e.g. insufficient balance, plan unavailable)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/servers": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "List your VPS services",
        "description": "Returns your VPS rows. Internal fields (`userId`, `externalId`, user profile columns, `product_*` SQL aliases) are **not** included.",
        "operationId": "listVpsServers",
        "responses": {
          "200": {
            "description": "Owned VPS services.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "hostname": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "price": {
                            "type": "string"
                          },
                          "cores": {
                            "type": "integer"
                          },
                          "ramGb": {
                            "type": "integer"
                          },
                          "storage": {
                            "type": "string"
                          },
                          "portSpeedGbps": {
                            "type": "number"
                          },
                          "trafficLimitTB": {
                            "type": "string"
                          },
                          "trafficUsageTB": {
                            "type": "string"
                          },
                          "ipv4Address": {
                            "type": "string",
                            "nullable": true
                          },
                          "ipv6Address": {
                            "type": "string",
                            "nullable": true
                          },
                          "powerStatus": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "autoRenew": {
                            "type": "string"
                          },
                          "emailExpiry": {
                            "type": "string"
                          },
                          "build": {
                            "type": "string"
                          },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "expiresAt": {
                            "type": "string",
                            "format": "date-time"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "vpsServers": {
                    "summary": "Active services",
                    "value": {
                      "success": true,
                      "data": [
                        {
                          "id": 188,
                          "hostname": "trivox.sh",
                          "name": "KVM-1",
                          "price": "3.99",
                          "cores": 1,
                          "ramGb": 2,
                          "storage": "10 GB NVMe",
                          "portSpeedGbps": 1,
                          "trafficLimitTB": "10.00",
                          "trafficUsageTB": "0.0000",
                          "ipv4Address": "193.178.226.122",
                          "ipv6Address": "2a14:9e00:800:3e::a",
                          "powerStatus": "Off",
                          "status": "Active",
                          "autoRenew": "True",
                          "emailExpiry": "True",
                          "build": "False",
                          "createdAt": "2026-05-15T08:10:45.000Z",
                          "expiresAt": "2026-06-14T08:10:45.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "VPS detail",
        "operationId": "getVpsDetailReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "VPS service detail.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "vps": {
                          "$ref": "#/components/schemas/VpsServicePublic"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "vpsDetail": {
                    "summary": "KVM-1 service",
                    "value": {
                      "success": true,
                      "data": {
                        "vps": {
                          "id": 188,
                          "hostname": "trivox.sh",
                          "name": "KVM-1",
                          "price": "3.99",
                          "cores": 1,
                          "ramGb": 2,
                          "storage": "10 GB NVMe",
                          "portSpeedGbps": 1,
                          "trafficLimitTB": "10",
                          "trafficUsageTB": "0",
                          "ipv4Address": "193.178.226.122",
                          "ipv6Address": "2a14:9e00:800:3e::a",
                          "powerStatus": "Off",
                          "status": "Active",
                          "autoRenew": "True",
                          "emailExpiry": "True",
                          "build": "False",
                          "createdAt": "2026-05-15T08:10:45.000Z",
                          "expiresAt": "2026-06-14T08:10:45.000Z"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/rename": {
      "patch": {
        "tags": [
          "VPS"
        ],
        "summary": "Rename VPS",
        "operationId": "renameVpsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 22,
                    "description": "New VPS name."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Name updated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Service name updated."
                    }
                  }
                },
                "examples": {
                  "vpsRenamed": {
                    "summary": "Rename succeeded",
                    "value": {
                      "success": true,
                      "message": "Service name updated."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/templates": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "OS templates for build",
        "description": "Operating system catalog for this VPS plan. Use the **leaf** `templates[].id` (e.g. `12` for Debian 12) as **`operatingSystemId`** in **`POST /vps/{id}/build`** — not the family `id` (`1` = Debian group).",
        "operationId": "getVpsTemplatesReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "OS families and install templates.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "packageId": {
                          "type": "integer"
                        },
                        "templates": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "integer",
                                "description": "OS family id (not used for build)."
                              },
                              "name": {
                                "type": "string"
                              },
                              "templates": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "integer",
                                      "description": "Use as `operatingSystemId`."
                                    },
                                    "name": {
                                      "type": "string"
                                    },
                                    "version": {
                                      "type": "string"
                                    },
                                    "variant": {
                                      "type": "string"
                                    },
                                    "type": {
                                      "type": "string"
                                    },
                                    "deployType": {
                                      "type": "integer"
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "vpsTemplates": {
                    "summary": "Template catalog (truncated)",
                    "value": {
                      "success": true,
                      "data": {
                        "templates": [
                          {
                            "id": 1,
                            "name": "Debian",
                            "templates": [
                              {
                                "id": 12,
                                "name": "Debian",
                                "version": "12 (Bookworm)",
                                "variant": "Minimal",
                                "type": "linux",
                                "deployType": 1,
                                "vnc": false
                              }
                            ]
                          }
                        ],
                        "packageId": 10
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/build": {
      "post": {
        "tags": [
          "VPS"
        ],
        "summary": "Start VPS build / install",
        "description": "Install or reinstall the VPS. **`operatingSystemId`** is required (from templates). Install email and IPv6 are always enabled server-side. On success the response is a **Trivox summary only** (no internal platform payload). When install credentials are available, **`data.loginUsername`** (typically `root`) and **`data.password`** are included in this Reseller API response. Store them securely — they are not shown again in the client panel API.",
        "operationId": "buildVpsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VpsBuildRequest"
              },
              "examples": {
                "debian12Build": {
                  "summary": "Install Debian 12",
                  "value": {
                    "operatingSystemId": 12,
                    "operatingSystemLabel": "Debian 12 (Bookworm)",
                    "hostname": "vm.example.com",
                    "vnc": false,
                    "sshKeys": []
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Build started.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "serviceId": {
                          "type": "integer",
                          "description": "VPS service id."
                        },
                        "buildState": {
                          "type": "string",
                          "description": "High-level install queue state (e.g. `queued`)."
                        },
                        "loginUsername": {
                          "type": "string",
                          "description": "SSH/login user for the installed OS (usually `root`). Present when install credentials are returned."
                        },
                        "password": {
                          "type": "string",
                          "description": "Root/login password for the install. Present only when returned in the build response. Omitted when not yet available."
                        },
                        "hostname": {
                          "type": "string",
                          "nullable": true,
                          "description": "Hostname used for the install (from request body or current service record)."
                        },
                        "ipv4Address": {
                          "type": "string",
                          "nullable": true,
                          "description": "IPv4 on the service at build time (comma-separated when multiple)."
                        },
                        "ipv6Address": {
                          "type": "string",
                          "nullable": true,
                          "description": "IPv6 on the service at build time."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "buildStarted": {
                    "summary": "Install queued with credentials",
                    "value": {
                      "success": true,
                      "message": "Build started. Login credentials are included in the response.",
                      "data": {
                        "serviceId": 188,
                        "buildState": "queued",
                        "hostname": "vm.example.com",
                        "ipv4Address": "203.0.113.10",
                        "ipv6Address": "2001:db8::10",
                        "loginUsername": "root",
                        "password": "ExampleTempPass123!"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/power/{action}": {
      "post": {
        "tags": [
          "VPS"
        ],
        "summary": "VPS power action",
        "description": "Supported power actions: **`boot`**, **`shutdown`**, **`restart`**, **`poweroff`**.",
        "operationId": "vpsPowerActionReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          },
          {
            "name": "action",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "boot",
                "shutdown",
                "restart",
                "poweroff"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Power action accepted.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "action": {
                          "type": "string",
                          "enum": [
                            "boot",
                            "shutdown",
                            "restart",
                            "poweroff"
                          ]
                        },
                        "powerStatus": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "powerShutdown": {
                    "summary": "Shutdown",
                    "value": {
                      "success": true,
                      "data": {
                        "action": "shutdown",
                        "powerStatus": "Off"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/power/status": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "VPS power status",
        "operationId": "getVpsPowerStatusReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "Current power status.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "powerStatus": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "powerStatusOff": {
                    "summary": "Server offline",
                    "value": {
                      "success": true,
                      "data": {
                        "powerStatus": "Off"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/vnc": {
      "get": {
        "tags": [
          "VPS",
          "Console"
        ],
        "summary": "Get VPS VNC console credentials",
        "description": "Returns WebSocket URL and password for embedding an HTML5 VNC client (noVNC) in your own panel — no separate control-panel login required.\n\nUse **`data.wssUrl`** as the WebSocket target and **`data.password`** as the VNC password. Treat both as secrets. VNC is enabled on first request if needed and **automatically disabled after 60 minutes** (configurable server-side).\n\nExample (noVNC): `new RFB(element, wssUrl, { credentials: { password } })`.",
        "operationId": "getVpsVncReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "VNC session credentials issued.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/VpsVncSession"
                    }
                  }
                },
                "examples": {
                  "vncSession": {
                    "summary": "HTML5 console credentials",
                    "value": {
                      "success": true,
                      "data": {
                        "wssUrl": "wss://cp.example.com/vnc/?token=69316231-d34a-4d36-b754-ffd3253df96d",
                        "password": "ZNYonJeU",
                        "ip": "192.168.4.2",
                        "port": 5903,
                        "enabled": true,
                        "autoDisableMinutes": 60
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request (e.g. service status blocks console)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found or not owned",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/reset-password": {
      "post": {
        "tags": [
          "VPS"
        ],
        "summary": "Reset VPS password",
        "description": "No request body required (optional `user` for Linux login name, default `root`). When the platform returns the new password immediately, **`data.password`** is included in this Reseller API response (same as **`POST /vps/{id}/build`**). Store it securely — it is not shown again in the client panel API. An install email may still be sent when configured on the account.",
        "operationId": "resetVpsPasswordReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "user": {
                    "type": "string",
                    "default": "root",
                    "description": "Linux user to reset (default root)."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Password reset queued.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "queueId": {
                          "type": "integer",
                          "nullable": true
                        },
                        "password": {
                          "type": "string",
                          "description": "New root/login password. Present only when returned by the platform. Omitted when not yet available."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "passwordResetQueued": {
                    "summary": "Reset queued with credentials",
                    "value": {
                      "success": true,
                      "message": "Password reset queued. New login credentials are included in the response.",
                      "data": {
                        "queueId": 1368,
                        "password": "ExampleTempPass123!"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/activity": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "VPS activity",
        "description": "Lifecycle events for this VPS: created, traffic notices, IPv4 add-ons, upgrades, and other logged actions.",
        "operationId": "getVpsActivityReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "Activity list.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "activity": {
                    "summary": "Recent events",
                    "value": {
                      "success": true,
                      "data": {
                        "activities": [
                          {
                            "id": "created-88",
                            "event": "Created",
                            "description": "Virtual server created",
                            "timestamp": "2026-06-01T10:00:00.000Z"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/upgrade/options": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "VPS upgrade options",
        "description": "Lists strictly larger packages available for this VPS, with remaining-term upgrade **`charge`** (EUR). Use **`productId`** from an option with `POST /vps/{id}/upgrade`.",
        "operationId": "getVpsUpgradeOptionsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "Upgrade catalog for this VPS.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/upgrade": {
      "post": {
        "tags": [
          "VPS"
        ],
        "summary": "Upgrade VPS package",
        "description": "Charges the remaining-term delta and applies the new package. Restart the VPS afterwards so the new resources take effect. Send **`productId`** from `GET /vps/{id}/upgrade/options`.",
        "operationId": "upgradeVpsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "productId"
                ],
                "properties": {
                  "productId": {
                    "type": "integer",
                    "description": "Target package id from upgrade options."
                  },
                  "targetProductId": {
                    "type": "integer",
                    "description": "Alias for `productId`."
                  }
                }
              },
              "examples": {
                "upgrade": {
                  "summary": "Upgrade",
                  "value": {
                    "productId": 12
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Upgrade applied.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/ips/availability": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "Extra IPv4 availability",
        "description": "How many extra IPv4 addresses can currently be attached to this VPS from the Trivox pool. `maxAvailable` may be `null` if stock cannot be determined. Also returns **`unitPrice`** (EUR per month) and **`negativeBalanceAvailable`** (reseller negative balance headroom for add-ons).",
        "operationId": "getVpsIpv4AvailabilityReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "Availability.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true,
                      "properties": {
                        "maxAvailable": {
                          "type": "integer",
                          "nullable": true
                        },
                        "unitPrice": {
                          "type": "number",
                          "description": "Monthly price per extra IPv4."
                        },
                        "negativeBalanceAvailable": {
                          "type": "number",
                          "example": 0,
                          "description": "EUR your wallet may go below 0 for this charge type (reseller negative balance). `0` when not enabled, not a reseller, or blocked by unpaid minus past the due window. A charge succeeds when `balance + negativeBalanceAvailable >= total`."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "stock": {
                    "summary": "Pool stock",
                    "value": {
                      "success": true,
                      "data": {
                        "maxAvailable": 8,
                        "unitPrice": 2.5,
                        "negativeBalanceAvailable": 0
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/ips": {
      "post": {
        "tags": [
          "VPS"
        ],
        "summary": "Add extra IPv4",
        "description": "Purchases extra IPv4 from the Trivox pool and attaches it to this VPS. Raises monthly price by the IPv4 addon unit price. Default **`quantity`** is `1` (max 64). Optional **`interface`**: `primary` (default) or `secondary`. The first month is charged to your wallet now. **Negative balance (resellers):** with **allow for VPS addons** and a **EUR limit** enabled, the wallet may go down to **`−limit`**; otherwise **`Insufficient balance`** is returned.",
        "operationId": "addVpsIpv4Reseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "quantity": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 64,
                    "default": 1
                  },
                  "interface": {
                    "type": "string",
                    "enum": [
                      "primary",
                      "secondary"
                    ],
                    "default": "primary"
                  }
                }
              },
              "examples": {
                "oneIp": {
                  "summary": "Add one IPv4",
                  "value": {
                    "quantity": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "IPv4 added.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "VPS"
        ],
        "summary": "Remove extra IPv4",
        "description": "Removes extra IPv4 from this VPS and lowers the monthly price. The primary IPv4 cannot be removed. Send **`ip`** to target a specific extra address, or **`quantity`** to remove the newest extras.",
        "operationId": "removeVpsIpv4Reseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ip": {
                    "type": "string",
                    "format": "ipv4"
                  },
                  "quantity": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 64,
                    "default": 1
                  }
                }
              },
              "examples": {
                "removeOne": {
                  "summary": "Remove one extra IP",
                  "value": {
                    "ip": "203.0.113.44"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "IPv4 removed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/ipv6/availability": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "Extra IPv6 /64 availability",
        "description": "How many extra IPv6 **/64** subnets can currently be attached to this VPS from the Trivox pool. `maxAvailable` may be `null` if stock cannot be determined. Also returns **`unitPrice`** (EUR per month) and **`negativeBalanceAvailable`** (reseller negative balance headroom for add-ons).",
        "operationId": "getVpsIpv6AvailabilityReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "Availability.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "additionalProperties": true,
                      "properties": {
                        "maxAvailable": {
                          "type": "integer",
                          "nullable": true
                        },
                        "unitPrice": {
                          "type": "number",
                          "description": "Monthly price per extra IPv6 /64."
                        },
                        "negativeBalanceAvailable": {
                          "type": "number",
                          "example": 0,
                          "description": "EUR your wallet may go below 0 for this charge type (reseller negative balance). `0` when not enabled, not a reseller, or blocked by unpaid minus past the due window. A charge succeeds when `balance + negativeBalanceAvailable >= total`."
                        },
                        "subnetSize": {
                          "type": "string",
                          "example": "/64"
                        },
                        "unsupported": {
                          "type": "boolean",
                          "description": "Present and `true` when attaching extra /64 after deploy is not available on this host yet."
                        },
                        "message": {
                          "type": "string",
                          "description": "Reason when `unsupported` is `true`."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "stock": {
                    "summary": "Pool stock",
                    "value": {
                      "success": true,
                      "data": {
                        "maxAvailable": 16,
                        "subnetSize": "/64",
                        "unitPrice": 1.5,
                        "negativeBalanceAvailable": 0
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/ipv6": {
      "post": {
        "tags": [
          "VPS"
        ],
        "summary": "Add extra IPv6 /64",
        "description": "Purchases extra IPv6 **/64** subnet(s) from the Trivox pool and attaches them to this VPS. Raises monthly price by the IPv6 addon unit price. Default **`quantity`** is `1` (max 64). Optional **`interface`**: `primary` (default) or `secondary`. The first month is charged to your wallet now. **Negative balance (resellers):** with **allow for VPS addons** and a **EUR limit** enabled, the wallet may go down to **`−limit`**; otherwise **`Insufficient balance`** is returned.",
        "operationId": "addVpsIpv6Reseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "quantity": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 64,
                    "default": 1
                  },
                  "interface": {
                    "type": "string",
                    "enum": [
                      "primary",
                      "secondary"
                    ],
                    "default": "primary"
                  }
                }
              },
              "examples": {
                "oneSubnet": {
                  "summary": "Add one /64",
                  "value": {
                    "quantity": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "IPv6 /64 added.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "VPS"
        ],
        "summary": "Remove extra IPv6 /64",
        "description": "Removes extra IPv6 **/64** subnet(s) from this VPS and lowers the monthly price. The included/primary IPv6 subnet cannot be removed. Send **`subnet`** (or **`ip`**) to target a specific extra subnet, or **`quantity`** to remove the newest extras.",
        "operationId": "removeVpsIpv6Reseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "subnet": {
                    "type": "string",
                    "description": "IPv6 address or CIDR, e.g. `2001:db8:1::/64`."
                  },
                  "ip": {
                    "type": "string",
                    "description": "Alias of `subnet`."
                  },
                  "quantity": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 64,
                    "default": 1
                  },
                  "interface": {
                    "type": "string",
                    "enum": [
                      "primary",
                      "secondary"
                    ],
                    "default": "primary"
                  }
                }
              },
              "examples": {
                "removeOne": {
                  "summary": "Remove one extra /64",
                  "value": {
                    "subnet": "2001:db8:1::/64"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "IPv6 /64 removed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/traffic": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "VPS traffic (monthly series)",
        "description": "Returns byte counters per billing month (`rx`, `tx`, `total`). The live response may include many months; the example is truncated.",
        "operationId": "getVpsTrafficReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "Monthly traffic series.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "monthly": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "month": {
                                "type": "integer"
                              },
                              "start": {
                                "type": "string"
                              },
                              "end": {
                                "type": "string"
                              },
                              "rx": {
                                "type": "integer",
                                "description": "Inbound bytes."
                              },
                              "tx": {
                                "type": "integer",
                                "description": "Outbound bytes."
                              },
                              "total": {
                                "type": "integer"
                              },
                              "limit": {
                                "type": "integer"
                              },
                              "blocks": {
                                "type": "array",
                                "items": {
                                  "type": "object"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "monthlyTraffic": {
                    "summary": "Monthly series (truncated)",
                    "value": {
                      "success": true,
                      "data": {
                        "monthly": [
                          {
                            "month": 10,
                            "start": "2026-05-13 00:00:00",
                            "end": "2026-06-12 23:59:59",
                            "rx": 5292311423,
                            "tx": 2162151587,
                            "total": 7454463010,
                            "limit": 0,
                            "blocks": []
                          },
                          {
                            "month": 9,
                            "start": "2026-04-13 00:00:00",
                            "end": "2026-05-12 23:59:59",
                            "rx": 23010829018,
                            "tx": 15892637038,
                            "total": 38903466056,
                            "limit": 0,
                            "blocks": []
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/rdns": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "Get PTR",
        "description": "Query **`ip`** must be the VPS primary IPv4 (`ipv4Address`). Same shape as dedicated rDNS. **`ptr`** is `null` if unset.",
        "operationId": "getVpsRdnsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          },
          {
            "name": "ip",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "ipv4"
            },
            "description": "Trivox-assigned IPv4 on this VPS."
          }
        ],
        "responses": {
          "200": {
            "description": "PTR record (or null).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/RdnsPtrData"
                    }
                  }
                },
                "examples": {
                  "ptrUnset": {
                    "summary": "No PTR yet",
                    "value": {
                      "success": true,
                      "data": {
                        "ip": "193.178.226.122",
                        "ptr": null
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "VPS"
        ],
        "summary": "Set PTR",
        "description": "Create or update PTR (same response shape as dedicated `POST /dedicated/{id}/rdns`).",
        "operationId": "setVpsRdnsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ip",
                  "ptr"
                ],
                "properties": {
                  "ip": {
                    "type": "string",
                    "format": "ipv4"
                  },
                  "ptr": {
                    "type": "string",
                    "description": "FQDN hostname for PTR."
                  }
                }
              },
              "examples": {
                "setPtr": {
                  "summary": "Set PTR",
                  "value": {
                    "ip": "193.178.226.122",
                    "ptr": "vps-188.example.com"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "PTR updated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/RdnsPtrData"
                    }
                  }
                },
                "examples": {
                  "setPtrSuccess": {
                    "summary": "PTR set",
                    "value": {
                      "success": true,
                      "data": {
                        "ip": "193.178.226.122",
                        "ptr": "vps-188.example.com"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "VPS"
        ],
        "summary": "Delete PTR",
        "description": "Remove PTR for an IPv4 (same response shape as dedicated `DELETE /dedicated/{id}/rdns`). Body: **`ip`** only.",
        "operationId": "deleteVpsRdnsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ip"
                ],
                "properties": {
                  "ip": {
                    "type": "string",
                    "format": "ipv4"
                  }
                }
              },
              "examples": {
                "deletePtr": {
                  "summary": "Delete PTR",
                  "value": {
                    "ip": "193.178.226.122"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "PTR removed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/RdnsPtrData"
                    }
                  }
                },
                "examples": {
                  "deletePtrSuccess": {
                    "summary": "PTR deleted",
                    "value": {
                      "success": true,
                      "data": {
                        "ip": "193.178.226.122",
                        "ptr": null
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/ssh-keys": {
      "get": {
        "tags": [
          "VPS"
        ],
        "summary": "List SSH keys",
        "operationId": "listVpsSshKeysReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "SSH keys stored on your Trivox account for use at VPS install time.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "keys": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/VpsSshKey"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "sshKeyList": {
                    "summary": "One key",
                    "value": {
                      "success": true,
                      "data": {
                        "keys": [
                          {
                            "id": 13,
                            "name": "test",
                            "publicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOMqqnkVzrm0SdG6UOoqKLsabgH5C9okWi0dh2l9GKJl user@hostname",
                            "type": "OpenSSH",
                            "enabled": true,
                            "createdAt": "2026-05-15T10:32:47+00:00",
                            "updatedAt": "2026-05-15T10:32:47+00:00"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "VPS"
        ],
        "summary": "Add SSH key",
        "operationId": "addVpsSshKeyReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "publicKey"
                ],
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "publicKey": {
                    "type": "string",
                    "description": "OpenSSH public key line."
                  }
                }
              },
              "examples": {
                "addKey": {
                  "summary": "Add ed25519 key",
                  "value": {
                    "name": "test",
                    "publicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOMqqnkVzrm0SdG6UOoqKLsabgH5C9okWi0dh2l9GKJl user@hostname"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "SSH key created.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "key": {
                          "$ref": "#/components/schemas/VpsSshKey"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "sshKeyAdded": {
                    "summary": "Key created",
                    "value": {
                      "success": true,
                      "message": "SSH key added.",
                      "data": {
                        "key": {
                          "id": 13,
                          "name": "test",
                          "publicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOMqqnkVzrm0SdG6UOoqKLsabgH5C9okWi0dh2l9GKJl user@hostname",
                          "type": "OpenSSH",
                          "enabled": true,
                          "createdAt": "2026-05-15T10:32:47+00:00",
                          "updatedAt": "2026-05-15T10:32:47+00:00"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/ssh-keys/{keyId}": {
      "delete": {
        "tags": [
          "VPS"
        ],
        "summary": "Delete SSH key",
        "operationId": "deleteVpsSshKeyReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          },
          {
            "name": "keyId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "SSH key deleted. The key must belong to the authenticated reseller.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "sshKeyDeleted": {
                    "summary": "Deleted",
                    "value": {
                      "success": true,
                      "message": "SSH key deleted."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "VPS was not found, or the SSH key is not one of the caller's keys.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/billing/auto-renew": {
      "post": {
        "tags": [
          "VPS billing"
        ],
        "summary": "VPS auto-renew",
        "operationId": "setVpsAutoRenewReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "enable"
                ],
                "properties": {
                  "enable": {
                    "type": "boolean"
                  }
                }
              },
              "examples": {
                "enableAutoRenew": {
                  "summary": "Enable",
                  "value": {
                    "enable": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Auto-renew updated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "autoRenew": {
                          "type": "string",
                          "enum": [
                            "True",
                            "False"
                          ]
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "autoRenewOn": {
                    "summary": "Enabled",
                    "value": {
                      "success": true,
                      "data": {
                        "autoRenew": "True"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/billing/email-notify": {
      "post": {
        "tags": [
          "VPS billing"
        ],
        "summary": "VPS expiry email notifications",
        "operationId": "setVpsEmailNotifyReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "enable"
                ],
                "properties": {
                  "enable": {
                    "type": "boolean"
                  }
                }
              },
              "examples": {
                "enableEmailNotify": {
                  "summary": "Enable",
                  "value": {
                    "enable": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Expiry email preference updated.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "emailExpiry": {
                          "type": "string",
                          "enum": [
                            "True",
                            "False"
                          ]
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "emailNotifyOn": {
                    "summary": "Enabled",
                    "value": {
                      "success": true,
                      "data": {
                        "emailExpiry": "True"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/billing/renew/options": {
      "get": {
        "tags": [
          "VPS billing"
        ],
        "summary": "VPS renewal options",
        "description": "Returns term lengths with **env-based** discounts (`discount` is a fraction, e.g. `0.05` = 5% off gross). Use `months` from an option with **`POST .../billing/renew`**. Includes current wallet **`balance`** and **`negativeBalanceAvailable`** (reseller negative balance headroom for manual renew). Fails if the VPS is **Expired**/**Cancelled**/**Refunded** or the upstream VM no longer exists (removed after the grace period).",
        "operationId": "getVpsRenewOptionsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "Renewal price options.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "options": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "months": {
                                "type": "integer",
                                "enum": [
                                  1,
                                  3,
                                  6,
                                  12
                                ]
                              },
                              "monthly": {
                                "type": "number"
                              },
                              "discount": {
                                "type": "number"
                              },
                              "gross": {
                                "type": "number"
                              },
                              "total": {
                                "type": "number"
                              }
                            }
                          }
                        },
                        "balance": {
                          "type": "number",
                          "nullable": true
                        },
                        "negativeBalanceAvailable": {
                          "type": "number",
                          "example": 0,
                          "description": "EUR your wallet may go below 0 for this charge type (reseller negative balance). `0` when not enabled, not a reseller, or blocked by unpaid minus past the due window. A charge succeeds when `balance + negativeBalanceAvailable >= total`."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "renewOptions": {
                    "summary": "Four terms",
                    "value": {
                      "success": true,
                      "data": {
                        "options": [
                          {
                            "months": 1,
                            "monthly": 3.99,
                            "discount": 0,
                            "gross": 3.99,
                            "total": 3.99
                          },
                          {
                            "months": 3,
                            "monthly": 3.99,
                            "discount": 0.05,
                            "gross": 11.97,
                            "total": 11.37
                          },
                          {
                            "months": 6,
                            "monthly": 3.99,
                            "discount": 0.15,
                            "gross": 23.94,
                            "total": 20.35
                          },
                          {
                            "months": 12,
                            "monthly": 3.99,
                            "discount": 0.2,
                            "gross": 47.88,
                            "total": 38.3
                          }
                        ],
                        "balance": 3228.58,
                        "negativeBalanceAvailable": 0
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/billing/renew": {
      "post": {
        "tags": [
          "VPS billing"
        ],
        "summary": "Renew VPS",
        "description": "Charges wallet and extends **`expiresAt`**. **`months`** must be one of `1`, `3`, `6`, or `12` (see **`GET .../renew/options`**).\n\nRenew is refused (no charge) when the VPS is **Expired**/**Cancelled**/**Refunded**, or when the upstream VM is already gone after the post-expiry grace period. During grace the VM stays suspended and renewable.\n\n**Negative balance:** With panel **negative balance** enabled, a **EUR limit** and **allow for VPS renews** (or **VPS auto-renews**), this call may take the wallet down to **`−limit`**. **Platform auto-renew** (service auto-renew on) uses the same limit when **VPS auto-renews**, **VPS renews** or **VPS orders** is allowed.",
        "operationId": "renewVpsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "months"
                ],
                "properties": {
                  "months": {
                    "type": "integer",
                    "enum": [
                      1,
                      3,
                      6,
                      12
                    ]
                  }
                }
              },
              "examples": {
                "renewOneMonth": {
                  "summary": "1 month",
                  "value": {
                    "months": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Renewal successful.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "months": {
                          "type": "integer"
                        },
                        "total": {
                          "type": "number"
                        },
                        "newExpiry": {
                          "type": "string",
                          "description": "`YYYY-MM-DD HH:mm:ss` (server local formatting)."
                        },
                        "invoiceId": {
                          "type": "integer",
                          "nullable": true
                        },
                        "balance": {
                          "type": "number",
                          "nullable": true
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "renewSuccess": {
                    "summary": "1 month renewed",
                    "value": {
                      "success": true,
                      "message": "Renewal successful.",
                      "data": {
                        "months": 1,
                        "total": 3.99,
                        "newExpiry": "2026-07-14 08:10:45",
                        "invoiceId": 929,
                        "balance": 3224.59
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/billing/traffic-addon/options": {
      "get": {
        "tags": [
          "VPS billing"
        ],
        "summary": "Traffic add-on options",
        "description": "Unlike dedicated traffic add-ons, VPS uses **`mode`** + **`tbAmount`** only (no `upgradeKey` tiers). Prices come from **`oneTimePricePerTB`** and **`recurringPricePerTB`**.\n\n**Recurring mid-cycle proration:** response includes **`proration`** (`daysRemaining`, `daysPerMonth` 30, `expiresAt`). Immediate wallet charge is `tbAmount × recurringPricePerTB × daysRemaining / 30`; monthly VPS price still rises by the full `tbAmount × recurringPricePerTB`.",
        "operationId": "getVpsTrafficAddonOptionsReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "Traffic add-on pricing and limits.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "minIncludedTrafficTB": {
                          "type": "number"
                        },
                        "currentTrafficLimitTB": {
                          "type": "number"
                        },
                        "oneTimePoolRemainingTB": {
                          "type": "number"
                        },
                        "effectiveTrafficLimitTB": {
                          "type": "number"
                        },
                        "currentMonthlyPrice": {
                          "type": "number"
                        },
                        "oneTimePricePerTB": {
                          "type": "number"
                        },
                        "recurringPricePerTB": {
                          "type": "number"
                        },
                        "pricePerTB": {
                          "type": "number",
                          "description": "Alias for one-time price."
                        },
                        "proration": {
                          "type": "object",
                          "properties": {
                            "daysRemaining": {
                              "type": "integer"
                            },
                            "daysPerMonth": {
                              "type": "integer",
                              "example": 30
                            },
                            "expiresAt": {
                              "type": "string",
                              "format": "date-time",
                              "nullable": true
                            }
                          }
                        },
                        "modes": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string",
                                "enum": [
                                  "one_time",
                                  "recurring"
                                ]
                              },
                              "label": {
                                "type": "string"
                              },
                              "description": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "limits": {
                          "type": "object",
                          "properties": {
                            "minTb": {
                              "type": "integer"
                            },
                            "maxTb": {
                              "type": "integer"
                            }
                          }
                        },
                        "balance": {
                          "type": "number",
                          "nullable": true
                        },
                        "negativeBalanceAvailable": {
                          "type": "number",
                          "example": 0,
                          "description": "EUR your wallet may go below 0 for this charge type (reseller negative balance). `0` when not enabled, not a reseller, or blocked by unpaid minus past the due window. A charge succeeds when `balance + negativeBalanceAvailable >= total`."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "vpsTrafficOptions": {
                    "summary": "10 TB plan",
                    "value": {
                      "success": true,
                      "data": {
                        "minIncludedTrafficTB": 10,
                        "currentTrafficLimitTB": 10,
                        "oneTimePoolRemainingTB": 0,
                        "effectiveTrafficLimitTB": 10,
                        "currentMonthlyPrice": 3.99,
                        "oneTimePricePerTB": 1,
                        "recurringPricePerTB": 0.5,
                        "pricePerTB": 1,
                        "proration": {
                          "daysRemaining": 12,
                          "daysPerMonth": 30,
                          "expiresAt": "2026-11-12T12:00:00.000Z"
                        },
                        "modes": [
                          {
                            "key": "one_time",
                            "label": "One-time boost",
                            "description": "Charged once. Adds traffic limit without changing monthly VPS price."
                          },
                          {
                            "key": "recurring",
                            "label": "Recurring add-on",
                            "description": "Adds traffic limit and increases monthly VPS price permanently. Due now is prorated for days left until renewal (flat 30-day month)."
                          }
                        ],
                        "limits": {
                          "minTb": 1,
                          "maxTb": 100
                        },
                        "balance": 3224.59,
                        "negativeBalanceAvailable": 0
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/billing/traffic-addon/purchase": {
      "post": {
        "tags": [
          "VPS billing"
        ],
        "summary": "Purchase VPS traffic add-on",
        "description": "Charges your wallet and applies the add-on. Call **`GET .../traffic-addon/options`** first.\n\n**`mode`** (required): **`one_time`** or **`recurring`**.\n\n- **`one_time`**: adds TB to a consumable pool at **`oneTimePricePerTB`**; does not change monthly VPS price.\n- **`recurring`**: permanently increases **`trafficLimitTB`** and monthly VPS price by **`tbAmount × recurringPricePerTB`**. Wallet charge **`total`** is that monthly amount prorated for days left until renewal (flat 30-day month). Response includes **`monthlyAmount`** and **`proration`**.\n\n**`tbAmount`** (required): integer between **`limits.minTb`** and **`limits.maxTb`** from options.\n\n**Negative balance (resellers):** with **allow for VPS addons** and a **EUR limit** enabled, the wallet may go down to **`−limit`** for this charge (see **`negativeBalanceAvailable`** on options).",
        "operationId": "purchaseVpsTrafficAddonReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "mode",
                  "tbAmount"
                ],
                "properties": {
                  "mode": {
                    "type": "string",
                    "enum": [
                      "one_time",
                      "recurring"
                    ],
                    "description": "One-time pool boost or recurring limit + monthly price increase."
                  },
                  "tbAmount": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "TB to purchase (within options `limits`)."
                  }
                }
              },
              "examples": {
                "oneTimePurchase": {
                  "summary": "One-time 5 TB boost",
                  "value": {
                    "mode": "one_time",
                    "tbAmount": 5
                  }
                },
                "recurringPurchase": {
                  "summary": "Recurring +10 TB",
                  "value": {
                    "mode": "recurring",
                    "tbAmount": 10
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Traffic add-on purchased.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "mode": {
                          "type": "string",
                          "enum": [
                            "one_time",
                            "recurring"
                          ]
                        },
                        "tbAmount": {
                          "type": "number"
                        },
                        "oneTimePricePerTB": {
                          "type": "number"
                        },
                        "recurringPricePerTB": {
                          "type": "number"
                        },
                        "pricePerTB": {
                          "type": "number"
                        },
                        "total": {
                          "type": "number",
                          "description": "Amount charged to the wallet now (prorated for recurring)."
                        },
                        "monthlyAmount": {
                          "type": "number",
                          "description": "Full monthly delta added to VPS renewal price (recurring only; 0 for one-time)."
                        },
                        "proration": {
                          "type": "object",
                          "nullable": true,
                          "properties": {
                            "daysRemaining": {
                              "type": "integer"
                            },
                            "daysPerMonth": {
                              "type": "integer"
                            },
                            "expiresAt": {
                              "type": "string",
                              "format": "date-time",
                              "nullable": true
                            },
                            "monthlyAmount": {
                              "type": "number"
                            },
                            "dueNow": {
                              "type": "number"
                            }
                          }
                        },
                        "invoiceId": {
                          "type": "integer",
                          "nullable": true
                        },
                        "currentTrafficLimitTB": {
                          "type": "number"
                        },
                        "oneTimePoolRemainingTB": {
                          "type": "number"
                        },
                        "oneTimePoolPurchasedTB": {
                          "type": "number"
                        },
                        "effectiveTrafficLimitTB": {
                          "type": "number"
                        },
                        "currentMonthlyPrice": {
                          "type": "number"
                        },
                        "balance": {
                          "type": "number",
                          "nullable": true
                        },
                        "unsuspendedAfterTrafficAddon": {
                          "type": "boolean"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "recurringPurchased": {
                    "summary": "Recurring +10 TB",
                    "value": {
                      "success": true,
                      "message": "Traffic addon purchased successfully.",
                      "data": {
                        "mode": "recurring",
                        "tbAmount": 10,
                        "oneTimePricePerTB": 1,
                        "recurringPricePerTB": 0.5,
                        "pricePerTB": 0.5,
                        "total": 2,
                        "monthlyAmount": 5,
                        "proration": {
                          "daysRemaining": 12,
                          "daysPerMonth": 30,
                          "expiresAt": "2026-11-12T12:00:00.000Z",
                          "monthlyAmount": 5,
                          "dueNow": 2
                        },
                        "invoiceId": 930,
                        "currentTrafficLimitTB": 20,
                        "oneTimePoolRemainingTB": 0,
                        "oneTimePoolPurchasedTB": 0,
                        "effectiveTrafficLimitTB": 20,
                        "currentMonthlyPrice": 8.99,
                        "balance": 3219.59,
                        "unsuspendedAfterTrafficAddon": false
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/billing/traffic-addon/history": {
      "get": {
        "tags": [
          "VPS billing"
        ],
        "summary": "VPS traffic add-on history",
        "operationId": "getVpsTrafficAddonHistoryReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "Traffic add-on purchase history and one-time pool usage.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "oneTimePoolRemainingTB": {
                          "type": "number"
                        },
                        "oneTimePoolPurchasedTB": {
                          "type": "number"
                        },
                        "oneTimePoolConsumedTB": {
                          "type": "number"
                        },
                        "history": {
                          "type": "object",
                          "properties": {
                            "addons": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "integer"
                                  },
                                  "mode": {
                                    "type": "string",
                                    "enum": [
                                      "recurring",
                                      "one_time"
                                    ]
                                  },
                                  "status": {
                                    "type": "string"
                                  },
                                  "totalTb": {
                                    "type": "number"
                                  },
                                  "remainingTb": {
                                    "type": "number",
                                    "nullable": true
                                  },
                                  "consumedTb": {
                                    "type": "number",
                                    "nullable": true
                                  },
                                  "pricePerTb": {
                                    "type": "number"
                                  },
                                  "totalPrice": {
                                    "type": "number"
                                  },
                                  "recurringMonthlyDelta": {
                                    "type": "number",
                                    "nullable": true
                                  },
                                  "invoiceId": {
                                    "type": "integer",
                                    "nullable": true
                                  },
                                  "createdAt": {
                                    "type": "string",
                                    "format": "date-time"
                                  },
                                  "updatedAt": {
                                    "type": "string",
                                    "format": "date-time"
                                  }
                                }
                              }
                            },
                            "consumption": {
                              "type": "array",
                              "items": {
                                "type": "object"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "vpsTrafficHistory": {
                    "summary": "One-time boost on file",
                    "value": {
                      "success": true,
                      "data": {
                        "oneTimePoolRemainingTB": 3,
                        "oneTimePoolPurchasedTB": 5,
                        "oneTimePoolConsumedTB": 2,
                        "history": {
                          "addons": [
                            {
                              "id": 12,
                              "mode": "one_time",
                              "status": "active",
                              "totalTb": 5,
                              "remainingTb": 3,
                              "consumedTb": 2,
                              "pricePerTb": 1,
                              "totalPrice": 5,
                              "recurringMonthlyDelta": 0,
                              "invoiceId": 931,
                              "createdAt": "2026-05-15T11:00:00.000Z",
                              "updatedAt": "2026-05-15T11:00:00.000Z"
                            }
                          ],
                          "consumption": []
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/billing/traffic-addon/auto-expand": {
      "get": {
        "tags": [
          "VPS billing"
        ],
        "summary": "Get VPS traffic auto-expand settings",
        "description": "Returns auto-expand settings for this VPS. When **enabled**, a one-time traffic top-up of **`tbAmount`** TB is purchased automatically once usage reaches **`triggerPercent`** (default **95%**) of the effective traffic limit. Default is **disabled**. **`maxPrice`** is an optional cumulative EUR budget since last reset (`null` = no cap). Auto-buys use the VPS **one-time** EUR/TB rate.",
        "operationId": "getVpsTrafficAutoExpandReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "Current auto-expand settings.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/TrafficAutoExpandSettings"
                    }
                  }
                },
                "examples": {
                  "enabledWithBudget": {
                    "summary": "Enabled with spending budget",
                    "value": {
                      "success": true,
                      "data": {
                        "enabled": true,
                        "tbAmount": 10,
                        "maxPrice": 50,
                        "spentAmount": 10,
                        "remainingBudget": 40,
                        "triggerPercent": 95,
                        "minTb": 1,
                        "maxTb": 100,
                        "pricePerTB": 1,
                        "exists": true
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": [
          "VPS billing"
        ],
        "summary": "Update VPS traffic auto-expand settings",
        "description": "Enable/disable auto-expand and configure TB amount plus optional cumulative spending limit. Saving settings does **not** reset **`spentAmount`** — use **`POST .../auto-expand/reset-spent`** for that.",
        "operationId": "updateVpsTrafficAutoExpandReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrafficAutoExpandUpdateRequest"
              },
              "examples": {
                "enable": {
                  "summary": "Enable 2 TB auto-buy, no spending cap",
                  "value": {
                    "enabled": true,
                    "tbAmount": 2,
                    "maxPrice": null
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Settings saved.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Auto-expand settings saved."
                    },
                    "data": {
                      "$ref": "#/components/schemas/TrafficAutoExpandSettings"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/vps/{id}/billing/traffic-addon/auto-expand/reset-spent": {
      "post": {
        "tags": [
          "VPS billing"
        ],
        "summary": "Reset VPS auto-expand spending counter",
        "description": "Sets **`spentAmount`** back to **0** for this VPS so a configured **`maxPrice`** budget can be reused.",
        "operationId": "resetVpsTrafficAutoExpandSpentReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/VpsId"
          }
        ],
        "responses": {
          "200": {
            "description": "Spending counter reset.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Auto-expand spending counter reset."
                    },
                    "data": {
                      "$ref": "#/components/schemas/TrafficAutoExpandSettings"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/reseller/webhooks/ipn/events": {
      "servers": [
        {
          "url": "https://v2.trivox.sh/api",
          "description": "Reseller panel API (JWT)"
        }
      ],
      "get": {
        "tags": [
          "Webhooks (IPN)"
        ],
        "summary": "List IPN event types",
        "description": "Returns the catalog of outbound IPN event types with descriptions and sample payloads. Same data is embedded in `GET /reseller/webhooks/ipn/settings` as `eventCatalog`.",
        "operationId": "listIpnEvents",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Event catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/IpnEventCatalogEntry"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/reseller/webhooks/ipn/settings": {
      "servers": [
        {
          "url": "https://v2.trivox.sh/api",
          "description": "Reseller panel API (JWT)"
        }
      ],
      "get": {
        "tags": [
          "Webhooks (IPN)"
        ],
        "summary": "Get IPN webhook settings",
        "operationId": "getIpnSettings",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Current IPN settings (secret is masked)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/IpnSettings"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Webhooks (IPN)"
        ],
        "summary": "Save IPN webhook settings",
        "description": "Partial updates merge with existing values. When `enabled` is true, `webhookUrl` is required. Failover URL must differ from primary. `eventSubscriptions` keys match the event catalog (`dedicated.order.created`, `billing.invoice.paid`, etc.).",
        "operationId": "updateIpnSettings",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "enabled": {
                    "type": "boolean"
                  },
                  "webhookUrl": {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 2048
                  },
                  "failoverWebhookUrl": {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 2048
                  },
                  "payloadFormat": {
                    "type": "string",
                    "enum": [
                      "classic",
                      "all_strings"
                    ]
                  },
                  "deliveryMaxTries": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20
                  },
                  "failureNotifyCount": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 30
                  },
                  "failureNotifyIntervalMinutes": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 30
                  },
                  "customPayloadText": {
                    "type": "string"
                  },
                  "eventSubscriptions": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Saved settings",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "$ref": "#/components/schemas/IpnSettings"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/reseller/webhooks/ipn/regenerate-secret": {
      "servers": [
        {
          "url": "https://v2.trivox.sh/api",
          "description": "Reseller panel API (JWT)"
        }
      ],
      "post": {
        "tags": [
          "Webhooks (IPN)"
        ],
        "summary": "Regenerate IPN webhook secret",
        "description": "Returns the new plaintext secret once. Update your signature verification immediately; previous signatures become invalid.",
        "operationId": "regenerateIpnSecret",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "New secret",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "webhookSecret": {
                          "type": "string",
                          "example": "64-char hex"
                        }
                      },
                      "required": [
                        "webhookSecret"
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/reseller/webhooks/ipn/discord": {
      "servers": [
        {
          "url": "https://v2.trivox.sh/api",
          "description": "Reseller panel API (JWT)"
        }
      ],
      "get": {
        "tags": [
          "Webhooks (IPN)"
        ],
        "summary": "List Discord mirror webhooks",
        "operationId": "listIpnDiscordWebhooks",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Discord mirrors",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/IpnDiscordWebhook"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Webhooks (IPN)"
        ],
        "summary": "Add Discord mirror webhook",
        "operationId": "createIpnDiscordWebhook",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "webhookUrl"
                ],
                "properties": {
                  "label": {
                    "type": "string",
                    "maxLength": 120
                  },
                  "webhookUrl": {
                    "type": "string",
                    "description": "Must be `https://discord.com/api/webhooks/...`"
                  },
                  "enabled": {
                    "type": "boolean",
                    "default": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Created mirror",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "$ref": "#/components/schemas/IpnDiscordWebhook"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/reseller/webhooks/ipn/discord/{id}": {
      "servers": [
        {
          "url": "https://v2.trivox.sh/api",
          "description": "Reseller panel API (JWT)"
        }
      ],
      "put": {
        "tags": [
          "Webhooks (IPN)"
        ],
        "summary": "Update Discord mirror webhook",
        "operationId": "updateIpnDiscordWebhook",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string",
                    "maxLength": 120
                  },
                  "webhookUrl": {
                    "type": "string"
                  },
                  "enabled": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated mirror",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/IpnDiscordWebhook"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Webhooks (IPN)"
        ],
        "summary": "Delete Discord mirror webhook",
        "operationId": "deleteIpnDiscordWebhook",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Deleted",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/reseller/webhooks/ipn/logs": {
      "servers": [
        {
          "url": "https://v2.trivox.sh/api",
          "description": "Reseller panel API (JWT)"
        }
      ],
      "get": {
        "tags": [
          "Webhooks (IPN)"
        ],
        "summary": "List IPN delivery logs",
        "operationId": "listIpnDeliveryLogs",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 50,
              "minimum": 1,
              "maximum": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 0,
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated logs",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/IpnDeliveryLog"
                      }
                    },
                    "total": {
                      "type": "integer"
                    },
                    "limit": {
                      "type": "integer"
                    },
                    "offset": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/reseller/webhooks/ipn/logs/{id}": {
      "servers": [
        {
          "url": "https://v2.trivox.sh/api",
          "description": "Reseller panel API (JWT)"
        }
      ],
      "get": {
        "tags": [
          "Webhooks (IPN)"
        ],
        "summary": "Get IPN delivery log detail",
        "operationId": "getIpnDeliveryLog",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Log entry with payload and response body",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/IpnDeliveryLog"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/reseller/webhooks/ipn/test": {
      "servers": [
        {
          "url": "https://v2.trivox.sh/api",
          "description": "Reseller panel API (JWT)"
        }
      ],
      "post": {
        "tags": [
          "Webhooks (IPN)"
        ],
        "summary": "Send IPN test webhook",
        "description": "Delivers a signed test event (`ipn.test`) to the configured primary URL. Rate-limited to one request per 10 seconds per account.",
        "operationId": "testIpnWebhook",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Delivered",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/reseller/webhooks/dedicated-stock/config": {
      "servers": [
        {
          "url": "https://v2.trivox.sh/api",
          "description": "Reseller panel API (JWT)"
        }
      ],
      "get": {
        "tags": [
          "Webhooks (Dedicated stock)"
        ],
        "summary": "Get dedicated stock Discord webhook config",
        "operationId": "getDedicatedStockWebhookConfig",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Saved config",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/DedicatedStockWebhookConfig"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Webhooks (Dedicated stock)"
        ],
        "summary": "Save dedicated stock Discord webhook config",
        "description": "Discord-only alerts when dedicated inventory becomes available. `mode`: `trivox` (embed template + `templateConfig`) or `custom` (`customPayloadText` JSON with variable placeholders). Not signed with HMAC.",
        "operationId": "updateDedicatedStockWebhookConfig",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DedicatedStockWebhookConfig"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Saved",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "$ref": "#/components/schemas/DedicatedStockWebhookConfig"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/reseller/webhooks/dedicated-stock/test": {
      "servers": [
        {
          "url": "https://v2.trivox.sh/api",
          "description": "Reseller panel API (JWT)"
        }
      ],
      "post": {
        "tags": [
          "Webhooks (Dedicated stock)"
        ],
        "summary": "Send dedicated stock test webhook",
        "description": "POST sample Discord payload to `webhookUrl`. Rate-limited to one request per 10 seconds per account.",
        "operationId": "testDedicatedStockWebhook",
        "security": [
          {
            "PanelJwtBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "webhookUrl"
                ],
                "properties": {
                  "webhookUrl": {
                    "type": "string",
                    "format": "uri"
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "trivox",
                      "custom"
                    ],
                    "default": "trivox"
                  },
                  "templateConfig": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "customPayload": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "productId": {
                    "type": "integer",
                    "description": "Optional catalog product id for sample data"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Sent",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string"
                    },
                    "fallbackUsed": {
                      "type": "boolean",
                      "description": "True if Discord rejected components and a simplified payload was sent"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/ips/availability": {
      "get": {
        "tags": [
          "Dedicated"
        ],
        "summary": "Trivox IPv4 addon availability",
        "description": "How many extra Trivox-pool IPv4 addresses can be purchased for this dedicated (`quantity` on `POST /dedicated/{id}/ips`). Counts free addresses across every Trivox range at that datacenter.",
        "operationId": "getDedicatedIpv4AvailabilityReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "stock": {
                    "summary": "Pool stock",
                    "value": {
                      "success": true,
                      "data": {
                        "maxAvailable": 42,
                        "addonUnitPrice": 2.5,
                        "location": "TV-DB"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/ipv6/availability": {
      "get": {
        "tags": [
          "Dedicated"
        ],
        "summary": "Extra IPv6 /64 availability",
        "description": "How many extra IPv6 /64 prefixes can be purchased for this dedicated from the Databarn or NorthC site pool.",
        "operationId": "getDedicatedIpv6AvailabilityReseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "examples": {
                  "stock": {
                    "summary": "Pool stock",
                    "value": {
                      "success": true,
                      "data": {
                        "maxAvailable": 18,
                        "addonUnitPrice": 1.5,
                        "subnetSize": "/64",
                        "location": "TV-NC"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/dedicated/{id}/ipv6": {
      "post": {
        "tags": [
          "Dedicated"
        ],
        "summary": "Add extra IPv6 /64",
        "description": "Purchases extra IPv6 /64 prefix(es) from the Trivox site pool and assigns them. Raises monthly price by 1.50 EUR per /64. Default quantity 1 (max 64).",
        "operationId": "addDedicatedIpv6Reseller",
        "parameters": [
          {
            "$ref": "#/components/parameters/DedicatedId"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "quantity": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 64,
                    "default": 1
                  }
                }
              },
              "examples": {
                "one": {
                  "summary": "Add one /64",
                  "value": {
                    "quantity": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  }
}
