Skip to content
WP Engine |Hosting Platform API

Refresh Disk Usage for all installs associated with account

POST
/accounts/{account_id}/usage/refresh_disk_usage

Triggers an asynchronous job to recalculate the disk usage of installs associated with a specific account.

This endpoint initiates the refresh process and returns immediately with a success status. It does not return the updated usage data.

To check the status of the job and view the new data once it’s available, you must poll the GET /accounts/{account_id}/usage endpoint. A successful request will populate the account_storage_refresh_expected_time attribute in that endpoint’s response, indicating when the data is expected to be fresh.

Multiple requests for the same environment will result in a single recalculation.

account_id
required
string format: uuid

The unique identifier (UUID) of the account.

OK. The disk usage refresh has been successfully initiated. The response body for this request is always null.

Bad Request

Authentication Error

object
message
required

A message regarding the error that occurred on the server

string
Example
Bad Credentials
documentation_url

(Optional) A URL where documentation regarding this specific error can be found

string

Not Authorized

object
message
required

A message regarding the error that occurred on the server

string
Example
You don't have permission to perform that action
documentation_url

(Optional) A URL where documentation regarding this specific error can be found

string

Not Found. The account with the specified UUID could not be found.

object
message
required

A message regarding the error that occurred on the server

string
Example
Not Found
documentation_url

(Optional) A URL where documentation regarding this specific error can be found

string

Too many requests

Internal server error

An invalid response was received from an upstream server

Service unavailable

An unexpected error occurred.

object
message
required

A message regarding the error that occurred on the server

string
Example
An unexpected error occurred, please try again in a few minutes