Sign in

v44

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

Update procurement

⚠️ This endpoint is in public preview.

Update a procurement's configuration.

patch/preview/v2/procurements/{id}

Path parameters

idstring required

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

Example:proc_k3R-nX9vLm7Qp2Yw5Jd8F

Request body

namestring
instance_skustring
min_sell_price_dollars_per_node_hourstring

Price rate in dollars per node-hour.

max_buy_price_dollars_per_node_hourstring

Price rate in dollars per node-hour.

managed_window_minutesinteger nullable

How far ahead (in minutes) the procurement buys and sells compute. Higher values secure compute further in advance but commit to longer windows that may need to be sold when scaling down, potentially at a loss. Lower values reduce waste but risk compute being unavailable. Orders are placed in 1-hour blocks, so the furthest hour is secured up to managed_window_minutes - 60 minutes before it begins.

enabledboolean nullable

Example request

{
  "name": "my-resource-name",
  "instance_sku": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
  "min_sell_price_dollars_per_node_hour": "2.500000",
  "max_buy_price_dollars_per_node_hour": "2.500000"
}

Response

Procurement updated.

idstring required
resource_pathstring required

A resource path for a procurement resource. Format: sfc:procurement:<account>:<workspace>:<name>.

ownerstring required
workspacestring required
namestring required
object'procurement' required
min_sell_price_dollars_per_node_hourstring required

Price rate in dollars per node-hour.

max_buy_price_dollars_per_node_hourstring required

Price rate in dollars per node-hour.

managed_window_minutesinteger required

How far ahead (in minutes) the procurement buys and sells compute. Higher values secure compute further in advance but commit to longer windows that may need to be sold when scaling down, potentially at a loss. Lower values reduce waste but risk compute being unavailable. Orders are placed in 1-hour blocks, so the furthest hour is secured up to managed_window_minutes - 60 minutes before it begins.

enabledboolean required

Enable/disable the procurement. Disabling cancels all standing orders.

created_atinteger required

Unix timestamp.

updated_atinteger required

Unix timestamp.

Example response

{
  "id": "proc_k3R-nX9vLm7Qp2Yw5Jd8F",
  "resource_path": "sfc:procurement:<account_id>:<workspace>:<name>",
  "owner": "my-resource-name",
  "workspace": "my-resource-name",
  "name": "my-resource-name",
  "object": "procurement",
  "capacity": {
    "id": "cap_k3R-nX9vLm7Qp2Yw5Jd8F",
    "name": "my-resource-name"
  },
  "instance_sku": {
    "id": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
    "name": "my-resource-name"
  },
  "min_sell_price_dollars_per_node_hour": "2.500000",
  "max_buy_price_dollars_per_node_hour": "2.500000",
  "created_at": 1738972800,
  "updated_at": 1738972800
}