curl --request POST \
  --url https://gdeltcloud.com/api/v2/monitors/preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "subject": {
    "type": "entity",
    "entity_ids": [
      "<string>"
    ],
    "match": "coverage"
  },
  "trigger": {
    "type": "new_matches"
  },
  "schedule": {
    "timezone": "UTC",
    "daily_hour": 8
  }
}
'

import requests

url = "https://gdeltcloud.com/api/v2/monitors/preview"

payload = {
    "name": "<string>",
    "subject": {
        "type": "entity",
        "entity_ids": ["<string>"],
        "match": "coverage"
    },
    "trigger": { "type": "new_matches" },
    "schedule": {
        "timezone": "UTC",
        "daily_hour": 8
    }
}
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({
    name: '<string>',
    subject: {type: 'entity', entity_ids: ['<string>'], match: 'coverage'},
    trigger: {type: 'new_matches'},
    schedule: {timezone: 'UTC', daily_hour: 8}
  })
};

fetch('https://gdeltcloud.com/api/v2/monitors/preview', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "preview": {
    "success": true,
    "normalized_spec": {
      "alert_kind": "every_hit",
      "target_family": "cameoplus",
      "filters": {
        "selected_families": [
          "cameoplus",
          "conflict",
          "story"
        ],
        "countries": [
          "USA"
        ],
        "search": "port closure shipping disruption"
      },
      "evaluation": {
        "sample_limit": 10
      }
    },
    "primitive_name": "event_search",
    "sample_rows": [
      {
        "item_id": "story:story_example",
        "lane": "story",
        "id": "story_example",
        "title": "Port operations paused after labor disruption",
        "observed_at": "2026-08-24T13:42:00.000Z"
      }
    ],
    "sample_count": 3,
    "count_truncated": false,
    "candidate_limit": 100,
    "evaluation": {
      "would_trigger": true,
      "disposition": "triggered",
      "reason": "3 new matches found in the current window.",
      "current_count": 3,
      "baseline_average": null,
      "event_count": null,
      "story_count": null,
      "event_baseline_average": null,
      "story_baseline_average": null,
      "new_item_ids": [
        "story:story_example"
      ],
      "trigger_fingerprint": "sha256:opaque"
    },
    "execution_time_ms": 842,
    "window_start": "2026-08-24T13:00:00.000Z",
    "window_end": "2026-08-24T14:00:00.000Z",
    "window_label": "Rolling last hour UTC",
    "explanation": {
      "trigger_type_label": "New matches",
      "chart_kind": "simple_count",
      "interpretation_headline": "3 matches in this window",
      "interpretation_body": "Representative rows are shown below.",
      "formula_label": null,
      "did_trigger": true,
      "current_window_count": 3,
      "threshold_count": null,
      "baseline_average": null,
      "baseline_window_counts": [],
      "event_count": null,
      "story_count": null,
      "event_threshold": null,
      "story_threshold": null,
      "comparison_mode": null,
      "chart_points": [],
      "evidence_default_label": null,
      "evidence_event_label": null,
      "evidence_story_label": null
    }
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}