Sign in

v44

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-20129390589.6 KB
admin

⚠️ This endpoint is in public preview.

put/preview/v2/admin/instance_skus/{id}

Path parameters

idstring required
Example:isku_k3R-nX9vLm7Qp2Yw5Jd8F

Instance SKU ID

Request body

propertiesSfcApiInstanceType required
allow_modifyboolean

⚠️ DANGER — DO NOT SET THIS UNLESS YOU MEAN IT. ⚠️

When false (the default), every existing (key, value) pair must be present unchanged in properties — new keys can be added, but no existing key may be dropped or have its value rewritten. The trading engine treats SKU properties as the canonical hardware/visibility identity of the SKU; flipping audience: public → internal, dropping accelerator, or renaming a property retroactively reshapes every order, contract, and procurement that's already pointed at this SKU. Customers who trusted that the SKU they bought against was H100 will suddenly be matching against whatever you wrote.

Set this to true ONLY when you have audited every live procurement, order, and contract on this SKU and know for certain that the rewrite is intended (e.g. correcting a typo nobody has matched against yet, or renaming a property the trading engine doesn't key on). For everything else, create a new SKU and migrate.

Response

Updated instance SKU

object'instance_sku' required

Single discriminator for the instance-SKU object on both admin and public endpoints. They expose different field shapes but represent the same underlying resource (mirrors Stripe's pattern of one object discriminator per resource type, regardless of view).

idstring required
namestring

Example response

{
  "object": "instance_sku",
  "id": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
  "name": "my-resource-name",
  "properties": [
    {
      "key": {
        "name": "my-resource-name",
        "stable_at": 1738972800,
        "deprecated_at": 1738972800,
        "deleted_at": 1738972800,
        "created_at": 1738972800,
        "updated_at": 1738972800
      },
      "value": {
        "key": "my-resource-name",
        "name": "my-resource-name",
        "stable_at": 1738972800,
        "deprecated_at": 1738972800,
        "deleted_at": 1738972800,
        "created_at": 1738972800,
        "updated_at": 1738972800
      }
    }
  ],
  "total_scheduled_supply": [
    {
      "start_at": 1738972800,
      "end_at": 1738972800
    }
  ]
}