Pools

Read customer pool utilization from retained device hours

Read-only and available to account members. Defaults to the last 168 complete hours, ending at the current UTC hour. From is inclusive and to is exclusive. Both must align to UTC hours and the window must be positive and at most 31 days. Future or incomplete hours are rejected. Day buckets follow UTC calendar boundaries and may have shorter first or last buckets. The response includes current hosts without evidence and removed hosts with retained history. Queries never read raw telemetry. Requests over 100000 device-hour rows or host buckets return 422 instead of partial totals. Narrow the time window to retry.

get/v1/pools/{id}/utilization

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

fromstring date-time

Inclusive RFC3339 UTC-hour boundary. Defaults to 168 hours before to.

tostring date-time

Exclusive RFC3339 UTC-hour boundary. Defaults to the current UTC hour.

bucket'hour' | 'day'

Group retained hours by hour or UTC calendar day.

Response

Retained utilization and explicit measurement availability.

pool_idstring required
fromstring date-time required
tostring date-time required
bucket'hour' | 'day' required

Changes

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