Pools

Read retained burst proposals

Read burst intent for this customer-owned pool, including expired and no-op outcomes. Reads do not require Predict. Keyset pagination uses descending creation order. Follow next_cursor with the same pool and state filter.

get/v1/pools/{id}/proposals

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.

Query parameters

limitinteger
cursorstring

Opaque next_cursor returned for the same pool and state filter.

state'pending' | 'approved' | 'rejected' | 'expired' | 'no_op' | 'applying' | 'applied'

Optional lifecycle filter. Active records that passed their expiry are returned as expired.

Response

Retained burst proposals.

pool_idstring required
next_cursorstring nullable required

Changes

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