Sign in

v1

latestOpenAPI 3.1.02026-07-2665179189.7 KB
Deployments

Create deployment

⚠️ This endpoint is in public preview.

Create a generic deployment that uses capacity already owned in a pool, or a spot deployment that buys capacity for a specific instance SKU at or below a maximum rate.

post/preview/v2/deployments

Request body

OR

Example request

{
  "name": "my-resource-name",
  "pool": "pool_k3R-nX9vLm7Qp2Yw5Jd8F",
  "instance_sku": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
  "instance_template": "itmpl_k3R-nX9vLm7Qp2Yw5Jd8F",
  "instance_name_template": "my-fleet-{{nanoid(9)}}"
}

Response

Deployment created.

OR

Example response

{
  "id": "depl_k3R-nX9vLm7Qp2Yw5Jd8F",
  "resource_path": "sfc:deployment:<account_id>:<workspace>:<name>",
  "owner": "my-resource-name",
  "workspace": "my-resource-name",
  "workspace_id": "wksp_k3R-nX9vLm7Qp2Yw5Jd8F",
  "name": "my-resource-name",
  "capacity": {
    "id": "cap_k3R-nX9vLm7Qp2Yw5Jd8F",
    "name": "my-resource-name"
  },
  "pool": {
    "id": "pool_k3R-nX9vLm7Qp2Yw5Jd8F",
    "name": "my-resource-name"
  },
  "instance_sku": {
    "id": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
    "alias": "my-resource-name"
  },
  "instance_template": {
    "id": "itmpl_k3R-nX9vLm7Qp2Yw5Jd8F",
    "name": "my-resource-name"
  },
  "instance_name_template": "my-fleet-{{nanoid(9)}}",
  "created_at": 1738972800,
  "updated_at": 1738972800
}