Skip to main content
POST
Estimate an order

Authorizations

Authorization
string
header
required

Create an API token using sf tokens create or at https://sfcompute.com/account/api-keys.

Body

application/json
requirements
object
required

Key/value filters on instance SKU properties.

Keys are the property names instance SKUs carry on GET /v2/instance_skus (e.g. accelerator); values match each property's value spelling. The reserved instance_sku key pins to a single SKU by id.

Empty map = no constraints.

Example:
start_at
integer<int64>
required

Order start. Must align to a 60-second boundary.

Example:

1738972800

duration_seconds
integer<u-int64>
required

Order duration in seconds. Must be a positive multiple of 60.

Required range: x >= 0
node_count
integer<int32>
required

Number of nodes. Must be positive.

pool
null | string

Pool that receives compute when the order fills. Omit to get an estimate without pinning to a pool. The response body then returns a placeholder you must replace before submitting to /v2/orders.

Pattern: (pool_[0-9a-zA-Z_-]{1,21})|(sfc:pool:[a-zA-Z0-9._-]+(:[a-zA-Z0-9._-]+){2,2})
Example:

"pool_k3R-nX9vLm7Qp2Yw5Jd8F"

Response

Estimate result.

post_order_body
object
required

Ready-to-submit body for POST /v2/orders. Posting this body verbatim will fill at the estimated price.

fee
object
required

Fee policy for the matched instance SKU.

type
string
default:quoted
required
read-only
Allowed value: "quoted"
notices
object[]

Maintenance windows for the matched instance SKU overlapping the order's delivery window.