Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
curl --request PATCH \
--url https://gdeltcloud.com/api/v2/monitors/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://gdeltcloud.com/api/v2/monitors/{id}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://gdeltcloud.com/api/v2/monitors/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"monitor": {
"id": "5e1d3b89-9c34-4fa1-80fc-17f72f782b33",
"organization_id": "88949d2a-4f00-45cb-9d23-2d242ddfe74d",
"created_by": "c6951b53-952b-40bf-99fd-c9d97a176f38",
"name": "Port disruption watch",
"description": "New coverage of port closures and shipping disruption in the United States.",
"enabled": false,
"subject": {
"type": "topic"
},
"criteria": {
"data": "events_and_stories",
"search": "port closure shipping disruption",
"countries": [
"USA"
],
"family_filters": {
"cameoplus": {
"domains": [
"INFRASTRUCTURE"
],
"subcategories": []
},
"story": {
"categories": [
"cameoplus_infrastructure"
]
}
},
"fatalities_only": false
},
"trigger": {
"type": "new_matches"
},
"schedule": {
"cadence": "hourly",
"timezone": "UTC",
"daily_hour": 8
},
"delivery": {
"email": true,
"webhook": {
"configured": true,
"endpoint": "https://example.com/gdelt-webhook",
"consecutive_failures": 0,
"last_success_at": "2026-08-23T14:05:00.000Z",
"last_failure_at": null
}
},
"created_at": "2026-08-23T13:00:00.000Z",
"updated_at": "2026-08-23T14:05:00.000Z",
"last_checked_at": "2026-08-23T14:00:00.000Z",
"last_triggered_at": "2026-08-23T14:00:00.000Z",
"legacy": false
},
"webhook_signing_secret": null
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Update one Monitor. A new webhook_signing_secret is returned once only when the destination is first configured or explicitly rotated.
curl --request PATCH \
--url https://gdeltcloud.com/api/v2/monitors/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://gdeltcloud.com/api/v2/monitors/{id}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://gdeltcloud.com/api/v2/monitors/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"monitor": {
"id": "5e1d3b89-9c34-4fa1-80fc-17f72f782b33",
"organization_id": "88949d2a-4f00-45cb-9d23-2d242ddfe74d",
"created_by": "c6951b53-952b-40bf-99fd-c9d97a176f38",
"name": "Port disruption watch",
"description": "New coverage of port closures and shipping disruption in the United States.",
"enabled": false,
"subject": {
"type": "topic"
},
"criteria": {
"data": "events_and_stories",
"search": "port closure shipping disruption",
"countries": [
"USA"
],
"family_filters": {
"cameoplus": {
"domains": [
"INFRASTRUCTURE"
],
"subcategories": []
},
"story": {
"categories": [
"cameoplus_infrastructure"
]
}
},
"fatalities_only": false
},
"trigger": {
"type": "new_matches"
},
"schedule": {
"cadence": "hourly",
"timezone": "UTC",
"daily_hour": 8
},
"delivery": {
"email": true,
"webhook": {
"configured": true,
"endpoint": "https://example.com/gdelt-webhook",
"consecutive_failures": 0,
"last_success_at": "2026-08-23T14:05:00.000Z",
"last_failure_at": null
}
},
"created_at": "2026-08-23T13:00:00.000Z",
"updated_at": "2026-08-23T14:05:00.000Z",
"last_checked_at": "2026-08-23T14:00:00.000Z",
"last_triggered_at": "2026-08-23T14:00:00.000Z",
"legacy": false
},
"webhook_signing_secret": null
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
