Sign in

v44

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

Create capacity transfer

⚠️ This endpoint is in public preview.

Transfer some or all of one capacity into another

post/preview/v2/capacity_transfers

Headers

Idempotency-Keystring nullable

Unique key for idempotent transfer creation.

Request body

from_capacitystring required

A resource path like 'sfc:capacity:acme:prod:my-capacity' or an ID. Resource paths are human-readable but not stable - they change when resources are renamed or moved. IDs are stable and permanent.

to_capacitystring required

A resource path like 'sfc:capacity:acme:prod:my-capacity' or an ID. Resource paths are human-readable but not stable - they change when resources are renamed or moved. IDs are stable and permanent.

instance_skustring required

Example request

{
  "from_capacity": "cap_k3R-nX9vLm7Qp2Yw5Jd8F",
  "to_capacity": "cap_k3R-nX9vLm7Qp2Yw5Jd8F",
  "allocation_schedule_delta": [
    {
      "start_at": 1738972800,
      "end_at": 1738972800
    }
  ],
  "instance_sku": "isku_k3R-nX9vLm7Qp2Yw5Jd8F"
}

Response

Capacity transfer accepted.

object'capacity_transfer' required
idstring required
status'pending' | 'executed' | 'rejected' required
created_atinteger required

Unix timestamp.

from_capacitystring required
to_capacitystring required
rejected_reasonstring nullable

Reason a capacity transfer was rejected.

Example response

{
  "object": "capacity_transfer",
  "id": "cxfr_k3R-nX9vLm7Qp2Yw5Jd8F",
  "created_at": 1738972800,
  "from_capacity": "cap_k3R-nX9vLm7Qp2Yw5Jd8F",
  "to_capacity": "cap_k3R-nX9vLm7Qp2Yw5Jd8F",
  "instance_sku": {
    "id": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
    "name": "my-resource-name"
  },
  "allocation_schedule_delta": [
    {
      "start_at": 1738972800,
      "end_at": 1738972800
    }
  ]
}