Skip to main content
GET
ListLabelChanges

Query Parameters

story_id
string

Story identity hash (64 hex characters). Empty lists changes across all stories.

limit
integer<int32>

Maximum changes returned, newest first. 0 uses the default of 50; at most 200.

jmespath
string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

ListLabelChangesResponse lists changes from the last seven days, newest first.

changes
object[]
state
string

ok | unavailable. Unavailable means the log could not be read, not that it is empty.

retentionDays
integer<int32>

Retention window in days.

counts
object

LabelCounts is how many stories in the latest full English digest carry each label.