Skip to content
WP EngineDocumentation

Refresh account disk usage

POST
/accounts/{account_id}/usage/refresh_disk_usage
curl --request POST \
--url https://api.wpengineapi.com/v1/accounts/eeda3227-9a39-46ae-9e14-20958bb4e6c9/usage/refresh_disk_usage \
--header 'Authorization: Basic <credentials>'

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

Limitations & Warnings

  • Asynchronous: the request returns immediately and does not return the updated usage data. To check progress, poll GET /accounts/{account_id}/usage. A successful request populates the account_storage_refresh_expected_time attribute in that response, indicating when the data is expected to be fresh.
  • Multiple requests for the same environment result in a single recalculation.
account_id
required
string format: uuid

The unique identifier (UUID) of the account.

Example
eeda3227-9a39-46ae-9e14-20958bb4e6c9

Returns null. The disk usage refresh has been initiated.

Bad Request

Authentication Error

Media typeapplication/json
object
message
required

A message regarding the error that occurred on the server

string
documentation_url

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

string
Example
{
"message": "Bad Credentials"
}

Not Authorized

Media typeapplication/json
object
message
required

A message regarding the error that occurred on the server

string
documentation_url

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

string
Example
{
"message": "You don't have permission to perform that action"
}

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

Media typeapplication/json
object
message
required

A message regarding the error that occurred on the server

string
documentation_url

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

string
Example
{
"message": "Not Found"
}

Too many requests

Internal Server Error

An invalid response was received from an upstream server

Service unavailable

An unexpected error occurred.

Media typeapplication/json
object
message
required

A message regarding the error that occurred on the server

string
Example
{
"message": "An unexpected error occurred, please try again in a few minutes"
}