Sign in

v44

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

Create a new instance SKU with validated properties.

⚠️ This endpoint is in public preview.

Minimal compared to the v1 POST /v1/admin/clusters endpoint: this does not touch zones, workspaces, capacities, delivery fees, or zone metadata — only the trading-engine CreateCluster command with validated properties. Use the v1 endpoint if you need that extra provider-onboarding plumbing.

post/preview/v2/admin/instance_skus

Request body

ownerstring required
namestring required
propertiesSfcApiInstanceType required

Example request

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

Response

Instance SKU created

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