curl --request POST \
--url https://gdeltcloud.com/api/v2/monitors/batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
'import requests
url = "https://gdeltcloud.com/api/v2/monitors/batch"
payload = { "ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']})
};
fetch('https://gdeltcloud.com/api/v2/monitors/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"requested": 3,
"unique_ids": 2,
"affected": 2,
"affected_ids": [
"5e1d3b89-9c34-4fa1-80fc-17f72f782b33",
"a25a0364-ec5e-4375-874d-01faec47c319"
],
"not_found": []
}Batch enable, pause, or delete
Enable, pause, or delete up to 100 submitted Monitor ids. The response distinguishes submitted, unique, actually changed, and not-found ids; already-in-target-state rows are successful idempotent no-ops.
curl --request POST \
--url https://gdeltcloud.com/api/v2/monitors/batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
'import requests
url = "https://gdeltcloud.com/api/v2/monitors/batch"
payload = { "ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']})
};
fetch('https://gdeltcloud.com/api/v2/monitors/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"requested": 3,
"unique_ids": 2,
"affected": 2,
"affected_ids": [
"5e1d3b89-9c34-4fa1-80fc-17f72f782b33",
"a25a0364-ec5e-4375-874d-01faec47c319"
],
"not_found": []
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Body
Response
Success
True when every unique submitted id resolved and the atomic operation completed. An idempotent no-op still resolves successfully.
Number of ids submitted, including duplicates.
1 <= x <= 100Number of unique submitted ids processed.
1 <= x <= 100Number of unique Monitor ids that actually changed state or were deleted. Already-in-target-state no-ops are excluded.
0 <= x <= 100Unique ids that actually changed state or were deleted, in first-submitted order.
100Unique submitted ids that were not found in the active organization.
100
