Pools

Read pool configuration

get/v1/pools/{id}

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Path parameters

idstring required

Identifier returned by Nodus.

Response

Read pool configuration

idstring required
namestring required
kindstring required
statestring required
wait_policy'never' | 'after_wait' | 'cheaper' required

never keeps waiting for private capacity without market fallback. after_wait permits fallback after the retained wait. cheaper requires active Predict and a current forecast showing lower expected market completion cost. Missing evidence keeps waiting.

burst_approval'auto' | 'above_threshold' | 'always' required
burst_timeout_behaviour'keep_waiting' | 'cancel' required
predict_enabledboolean required
route_enabledboolean required
sandbox_capableboolean required
wait_alphanumber required

Finite nonnegative wait tolerance multiplier. New pools default to 0.1.

waiting_budget_pctnumber required
burst_threshold_microsinteger required

Approval threshold in USD micros.

platform_rate_microsinteger required

Accepted Route rate per active customer device-hour in USD micros. Retained when Route is disabled.

owned_cost_micros_per_hourinteger required

Customer-supplied owned hardware cost in USD micros per hour. This value does not create a charge.

created_atstring date-time required
updated_atstring date-time required
route_price_versionstring

Accepted Nodus Route pricing version. byoc-free-v1 with a zero platform rate identifies free cloud-connected execution. Absent before pricing terms are accepted. Retained when routing is disabled.

Changes

No recorded changes to this operation across all 70 revisions of this API.