Update Plan

Authorization

Authorization<token>

Bearer token

In: header

X-Organization-ID<token>

Tenant or organization identifier

In: header

Path Parameters

idstring

Plan ID to update (required)

Request Body

currency?string

planPrices?

addonPriceOverrides?

regionId?string

Region for this plan offer (optional on update).

cpuLimit?integer

Plan CPU/network scheduling overrides written into metadata.specifications. Only affects VMs created after the update (VMs snapshot plan values at create).

Formatint32

cpuUnits?integer

Formatint32

networkRateLimitMbs?number

Formatdouble

nodeIds?array<string>

When non-empty, replaces the plan's assigned nodes (same rules as create). Omitted / empty leaves existing assignments unchanged.

Response Body

application/json

curl -X PATCH "https://api.nrings.io/v1/plans/{id}" \
  -H "Authorization: Bearer {your_token}" \
  -H "X-Organization-ID: {your_org_id}" \
  -H "Content-Type: application/json" \
  -d '{
  "currency": "string",
  "planPrices": [
    {
      "metricId": "string",
      "planPriceId": "string",
      "unitAmount": "string",
      "freeUnits": 0,
      "minimumCharge": "string",
      "maximumCharge": "string"
    }
  ],
  "addonPriceOverrides": [
    {
      "addonCode": "string",
      "unitAmount": "string"
    }
  ],
  "regionId": "string",
  "cpuLimit": 0,
  "cpuUnits": 0,
  "networkRateLimitMbs": 0,
  "nodeIds": [
    "string"
  ]
}'

curl -X PATCH "https://api.nrings.io/v1/plans/{id}" \  -H "Authorization: Bearer {your_token}" \  -H "X-Organization-ID: {your_org_id}" \  -H "Content-Type: application/json" \  -d '{  "currency": "string",  "planPrices": [    {      "metricId": "string",      "planPriceId": "string",      "unitAmount": "string",      "freeUnits": 0,      "minimumCharge": "string",      "maximumCharge": "string"    }  ],  "addonPriceOverrides": [    {      "addonCode": "string",      "unitAmount": "string"    }  ],  "regionId": "string",  "cpuLimit": 0,  "cpuUnits": 0,  "networkRateLimitMbs": 0,  "nodeIds": [    "string"  ]}'

{
  "success": true
}

List Assignable Nodes For Plan GET

Nodes the provider may assign to a plan (catalog-eligible for tier/category).

Create Provider Review Reply POST