Sign in

v44

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

Patch an instance SKU's display metadata. Currently only `name` is updatable here — properties go through `PUT /admin/instance_skus/{id}/properties` (full replacement, with the dangerous-rewrite guards). Lookups still happen by id; the name is purely for display.

⚠️ This endpoint is in public preview.

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

Path parameters

idstring required
Example:isku_k3R-nX9vLm7Qp2Yw5Jd8F

Instance SKU ID

Request body

namestring

Example request

{
  "name": "my-resource-name"
}

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
    }
  ]
}