Research workspaces

Read the shared account saved-file allowance and charges

Changed on

Requires account authentication. Reports combined saved-file usage and the account storage policy, independent of compute-session charges.

get/v1/research-workspaces/storage

Request

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

Response

Account saved-file usage and billing

policy_versionstring required

Version of the account's saved-file storage policy.

included_bytesinteger required

Current shared free allowance across eligible saved files. An active storage promotion may provide an allowance.

retained_bytesinteger required

Verified saved-file payload covered by the current policy. Earlier research storage is reported separately in legacy_retained_bytes.

legacy_retained_bytesinteger

Saved research payload retaining earlier pricing, excluded from the current policy allowance.

legacy_charged_usdnumber

Lifetime posted research storage charges under the earlier policy.

billable_bytesinteger required

Saved payload above the account allowance.

rate_usd_gb_monthnumber required

Server-reported fixed USD rate per decimal GB-month when applicable. For measured-cost pricing, use pricing_basis and posted charges. A zero rate does not indicate free storage.

pricing_basisstring

Billing basis for storage charges when the policy does not use a fixed monthly rate.

charged_usdnumber required

Lifetime posted storage charges under the current policy, separate from compute and legacy_charged_usd.

status'inactive' | 'included' | 'funded' | 'funding_required' required
as_ofstring date-time required

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status