Skip to main content
POST
Refresh balances for the workspace

Authorizations

X-API-KEY
string
header
required

Authorization method required to allow user to access the api endpoints.

Response

200 - application/json
refreshed
number
required

Number of accounts whose balances were refreshed.

Example:

12

failed
number
required

Number of accounts whose balance refresh failed (e.g. provider error).

Example:

1

skipped
number
required

Number of accounts whose holdings could not be read at all — their chain has no readable balance source, or their connection's provider is no longer supported. Neither refreshed nor failed, since there is nothing to retry and nothing actionable to report. refreshed + failed + skipped is the total number of accounts this pass considered. Additive field (RNG-5758); clients reading only the existing counts keep working unmodified.

Example:

2

failures
object[]
required

Per-account detail, one entry per failed account; its length always matches failed. Always present — an empty array when nothing failed. Additive field, so older clients that only read the counts keep working.

Last modified on September 9, 2026