WatchlistRequest
Manage scoped watch configuration, not external institutional authority. Canonical action renew_scheduled_execution_authority (deprecated alias renew_authority) renews the current tenant credential reference used to run existing scheduled rules and authorized subscriptions. It does not change rule scope, renew consent/licences, attest evidence or authorize a business action. Renewal requires durable runtime, a renewable tenant credential and owner/admin/org_admin/security_admin role. First obtain renewal_preview; then confirm its unchanged, unexpired preview_hash/preview_expires_at and expected_revision with confirm_renewal=true. Preview validity is 15 minutes. The renewal mutation requires Idempotency-Key. Do not interpret authority_changed=true as external authority renewal.
Properties
| Name | Type | Description |
|---|---|---|
| action | string | renew_authority is deprecated; use renew_scheduled_execution_authority. Both renew the scheduler credential reference only; renewal_preview is read-only. |
| project_id | string | |
| watchlist_id | string | |
| country | string | |
| expected_revision | integer | Current stored revision for update or confirmed renewal. |
| preview_hash | string | |
| preview_expires_at | string | |
| confirm_renewal | boolean | |
| watched_dimensions | array | Canonical MVR dimensions from the same ALL_DIMS domain used by the handler. evidence_freshness is not a dimension; evidence_staleness is a market_event trigger, not proof of expiry. |
| trigger_rules | array | |
| patch | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/africanmarketos-com/json-schema/africanmarketos-com-watchlist-request-schema.json",
"title": "WatchlistRequest",
"description": "Manage scoped watch configuration, not external institutional authority. Canonical action renew_scheduled_execution_authority (deprecated alias renew_authority) renews the current tenant credential reference used to run existing scheduled rules and authorized subscriptions. It does not change rule scope, renew consent/licences, attest evidence or authorize a business action. Renewal requires durable runtime, a renewable tenant credential and owner/admin/org_admin/security_admin role. First obtain renewal_preview; then confirm its unchanged, unexpired preview_hash/preview_expires_at and expected_revision with confirm_renewal=true. Preview validity is 15 minutes. The renewal mutation requires Idempotency-Key. Do not interpret authority_changed=true as external authority renewal.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/africanmarketos-com-watchlist-api-openapi.yml#/components/schemas/WatchlistRequest",
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"list",
"update",
"delete",
"evaluate",
"renewal_preview",
"renew_scheduled_execution_authority",
"renew_authority"
],
"description": "renew_authority is deprecated; use renew_scheduled_execution_authority. Both renew the scheduler credential reference only; renewal_preview is read-only.",
"x-deprecated-values": [
"renew_authority"
]
},
"project_id": {
"type": "string"
},
"watchlist_id": {
"type": "string"
},
"country": {
"type": "string"
},
"expected_revision": {
"type": "integer",
"description": "Current stored revision for update or confirmed renewal."
},
"preview_hash": {
"type": "string"
},
"preview_expires_at": {
"type": "string",
"format": "date-time"
},
"confirm_renewal": {
"type": "boolean"
},
"watched_dimensions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"permission",
"trust",
"belonging",
"embeddedness",
"reciprocity",
"cultural_fit",
"guardian_strength",
"continuity",
"channel_permission",
"infrastructural_intimacy",
"absence_sensitivity",
"narrative_looping",
"whispered_credibility",
"fractal_trust",
"cultural_calibration"
]
},
"description": "Canonical MVR dimensions from the same ALL_DIMS domain used by the handler. evidence_freshness is not a dimension; evidence_staleness is a market_event trigger, not proof of expiry."
},
"trigger_rules": {
"type": "array",
"items": {
"$ref": "#/$defs/WatchlistTriggerRule"
}
},
"patch": {
"type": "object",
"additionalProperties": true,
"properties": {
"watched_dimensions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"permission",
"trust",
"belonging",
"embeddedness",
"reciprocity",
"cultural_fit",
"guardian_strength",
"continuity",
"channel_permission",
"infrastructural_intimacy",
"absence_sensitivity",
"narrative_looping",
"whispered_credibility",
"fractal_trust",
"cultural_calibration"
]
}
},
"trigger_rules": {
"type": "array",
"items": {
"$ref": "#/$defs/WatchlistTriggerRule"
}
}
}
}
},
"$defs": {
"WatchlistTriggerRule": {
"type": "object",
"additionalProperties": true,
"properties": {
"type": {
"type": "string",
"enum": [
"dimension_below",
"dimension_drop",
"market_event"
]
},
"dimension": {
"type": "string",
"enum": [
"permission",
"trust",
"belonging",
"embeddedness",
"reciprocity",
"cultural_fit",
"guardian_strength",
"continuity",
"channel_permission",
"infrastructural_intimacy",
"absence_sensitivity",
"narrative_looping",
"whispered_credibility",
"fractal_trust",
"cultural_calibration"
]
},
"threshold": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"threshold_delta": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"event_type": {
"type": "string",
"enum": [
"school_fees_window",
"harvest_inflow",
"harvest_outflow",
"pre_election_hoarding",
"post_election_normalisation",
"religious_fasting",
"religious_feasting",
"market_day_cycle",
"salary_cycle_peak",
"salary_cycle_trough",
"flooding_disruption",
"drought_period",
"festive_season",
"fuel_shortage",
"lab_window",
"formalization_wave",
"regulatory_shock",
"evidence_staleness"
]
}
},
"oneOf": [
{
"required": [
"type",
"dimension",
"threshold"
],
"properties": {
"type": {
"enum": [
"dimension_below"
]
}
}
},
{
"required": [
"type",
"dimension",
"threshold_delta"
],
"properties": {
"type": {
"enum": [
"dimension_drop"
]
}
}
},
{
"required": [
"type",
"event_type"
],
"properties": {
"type": {
"enum": [
"market_event"
]
}
}
}
],
"description": "Uses the canonical dimension and event domains of validateWatchlistTriggerRules. An event rule evaluates submitted/stored event context; it does not establish live evidence, expiry or revocation."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/africanmarketos-com-watchlist-request"
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.