Code Samples #
Copy
curl --request GET \
--url 'https://app.xcloud.host/api/v1/sites/{uuid}/wordpress/updates' \
--header 'Authorization: Bearer YOUR_TOKEN'
const response = await fetch('https://app.xcloud.host/api/v1/sites/{uuid}/wordpress/updates', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
});
const data = await response.json();
console.log(data);
import requests
headers = {
"Authorization": "Bearer YOUR_TOKEN"
}
response = requests.get("https://app.xcloud.host/api/v1/sites/{uuid}/wordpress/updates", headers=headers)
print(response.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://app.xcloud.host/api/v1/sites/{uuid}/wordpress/updates',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_TOKEN'
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
using System.Net.Http;
var client = new HttpClient();
var request = new HttpRequestMessage(new HttpMethod("GET"), "https://app.xcloud.host/api/v1/sites/{uuid}/wordpress/updates");
request.Headers.Add("Authorization", "Bearer YOUR_TOKEN");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
import java.net.URI;
import java.net.http.*;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://app.xcloud.host/api/v1/sites/{uuid}/wordpress/updates"))
.header("Authorization", "Bearer YOUR_TOKEN")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
Response #
Copy
{
"success": true,
"message": "Success",
"data": {
"site_uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"core": {
"current_version": "6.4.2",
"available_version": "6.5.0",
"update_available": true,
"is_security_update": false
},
"plugins": {
"total": 23,
"active": 18,
"with_updates": 5,
"with_security_updates": 1,
"items": [
{
"slug": "woocommerce",
"name": "WooCommerce",
"current_version": "8.5.2",
"available_version": "8.6.0",
"is_security_update": true
}
]
},
"themes": {
"total": 3,
"active": 1,
"with_updates": 1,
"with_security_updates": 0,
"items": []
},
"summary": {
"total_pending": 7,
"security_pending": 1,
"last_scanned_at": "2026-05-06T12:00:00Z"
}
}
}
{
"success": false,
"message": "Unauthenticated.",
"data": null
}
{
"success": false,
"message": "This action is unauthorized. Your token is missing the required scope.",
"data": null
}
{
"success": false,
"message": "Not found.",
"data": null
}
Returns a summary of pending WordPress updates (core, plugins, themes) for the site, with a security cross-reference flag per item. Requires the read:sites scope and the site:manage-update Team permission.
Path Parameters #
| Name | Type | Required | Description |
|---|---|---|---|
uuid | string (uuid) | Required | UUID of the site |
Query Parameters #
| Name | Type | Required | Description |
|---|---|---|---|
include_security_only | boolean | Optional |
Responses #
200 — WordPress updates summary #
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | Optional | |
message | string | Optional | |
data | object | Optional | |
data | object | Optional | |
data.site_uuid | string (uuid) | Optional | |
data.core | object | Optional | |
data.core.current_version | string | Optional | |
data.core.available_version | string | Optional | |
data.core.update_available | boolean | Optional | |
data.core.is_security_update | boolean | Optional | |
data.plugins | object | Optional | |
data.themes | object | Optional | |
data.summary | object | Optional | |
data.summary.total_pending | integer | Optional | |
data.summary.security_pending | integer | Optional | |
data.summary.last_scanned_at | string (date-time) | Optional |
Example 200 response
Copy
{
"success": true,
"message": "Success",
"data": {
"site_uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"core": {
"current_version": "6.4.2",
"available_version": "6.5.0",
"update_available": true,
"is_security_update": false
},
"plugins": {
"total": 23,
"active": 18,
"with_updates": 5,
"with_security_updates": 1,
"items": [
{
"slug": "woocommerce",
"name": "WooCommerce",
"current_version": "8.5.2",
"available_version": "8.6.0",
"is_security_update": true
}
]
},
"themes": {
"total": 3,
"active": 1,
"with_updates": 1,
"with_security_updates": 0,
"items": []
},
"summary": {
"total_pending": 7,
"security_pending": 1,
"last_scanned_at": "2026-05-06T12:00:00Z"
}
}
}
401 — Missing or invalid authentication token #
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | Optional | |
message | string | Optional | |
data | object | Optional |
Example 401 response
Copy
{
"success": false,
"message": "Unauthenticated.",
"data": null
}
403 — Token lacks the required scope #
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | Optional | |
message | string | Optional | |
data | object | Optional |
Example 403 response
Copy
{
"success": false,
"message": "This action is unauthorized. Your token is missing the required scope.",
"data": null
}
404 — Resource not found or not accessible to your Team #
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | Optional | |
message | string | Optional | |
data | object | Optional |
Example 404 response
Copy
{
"success": false,
"message": "Not found.",
"data": null
}
