Skip to main content
POST
Create or expand a shared Situation

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Headers

Idempotency-Key
string
required

Stable key for one admitted creation or expansion. Reuse the same key and body to retry a timed-out request; a different body needs a new key.

Required string length: 8 - 128
Pattern: ^[A-Za-z0-9._:-]{8,128}$

Body

application/json
story_id
string
required
Required string length: 1 - 256
event_uid
string
Required string length: 1 - 256
situation_uid
string
Required string length: 1 - 256
direction
enum<string>
default:forward
Available options:
back,
forward

Response

Created, expanded, or reused Situation. Reuse costs 0 QU; adjudication costs 5 QU.

success
enum<boolean>
required
Available options:
true
situation_uid
string
required
created
boolean
required
reused
boolean
required
added
number
required
considered
number
required
quota_units
required
Available options:
0
story_count
number
empty_reason
string | null