Skip to main content
GET
List hot-load replicas
Per-replica progress is a sub-resource: GetHotLoad returns the aggregate state only and does not embed replica status, so poll this endpoint separately. A replica is caught up when its state is READY and its currentSnapshotIdentity matches the hot-load’s target identity.
Example request

Authorizations

Authorization
string
header
default:Bearer {API_ACCESS_TOKEN}
required

CoreWeave API access token sent as a bearer token.

Path Parameters

hotLoadId
string
required

The ID of the hot-load whose replicas to list

Query Parameters

maxPageSize
integer<int32>

The maximum number of replicas to return. The service may return fewer than this value. If unspecified or 0, at most 50 replicas are returned. The maximum value is 1000; values above 1000 are coerced to 1000. A negative value is rejected with INVALID_ARGUMENT.

pageToken
string

A page token received from a previous ListHotLoadReplicas call. Provide this to retrieve the subsequent page. Use the same hot_load_id and organization as the previous call; otherwise, the token is rejected with INVALID_ARGUMENT. The token is opaque and must not be constructed by clients.

Response

OK

Response for ListHotLoadReplicas

replicas
object[]
read-only

The replicas of the hot-load, ordered by (zone, name)

nextPageToken
string
read-only

A token that can be sent as page_token to retrieve the next page. Empty when the final page has been reached.

Last modified on October 1, 2026