Refresh disk usage for the given WordPress site environment
package main
import ( "fmt" "net/http" "io")
func main() {
url := "https://api.wpengineapi.com/v1/installs/example/usage/refresh_disk_usage"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Basic <credentials>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close() body, _ := io.ReadAll(res.Body)
fmt.Println(res) fmt.Println(string(body))
}const url = 'https://api.wpengineapi.com/v1/installs/example/usage/refresh_disk_usage';const options = {method: 'POST', headers: {Authorization: 'Basic <credentials>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.wpengineapi.com/v1/installs/example/usage/refresh_disk_usage \ --header 'Authorization: Basic <credentials>'Triggers an asynchronous job to recalculate the disk usage for the given WordPress site environment.
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 for daily usage metrics at GET /installs/{install_id}/usage. The estimated time of completion can be viewed in daily usage metrics as the storage_refresh_expected_time field. If the field is null, the job has already completed.
The last time storage was refreshed can be viewed in the storage_update_time field of daily usage metrics.
Multiple requests for the same environment will result in a single recalculation.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The UUID of the install.
Responses
Section titled “ Responses ”OK. The disk usage refresh has been successfully initiated. The response body for this request is always null.
Bad Request
Authentication Error
object
A message regarding the error that occurred on the server
(Optional) A URL where documentation regarding this specific error can be found
Example
{ "message": "Bad Credentials"}Not authorized
object
A message regarding the error that occurred on the server
(Optional) A URL where documentation regarding this specific error can be found
Example
{ "message": "You don't have permission to perform that action"}Not found
object
A message regarding the error that occurred on the server
(Optional) A URL where documentation regarding this specific error can be found
Example
{ "message": "Not Found"}Too many requests
Internal server error
object
A message regarding the error that occurred on the server
Example
{ "message": "An unexpected error occurred, please try again in a few minutes"}An invalid response was received from an upstream server
Service unavailable
default
Section titled “default ”An unexpected error response.
object
A message regarding the error that occurred on the server
Example
{ "message": "An unexpected error occurred, please try again in a few minutes"}