{"openapi":"3.1.0","info":{"title":"Valyzer API","version":"1","description":"Public and authenticated surface of the Valyzer API. `/v1/internal/**` (service-token-only ingestion, pipeline, and editorial-operations boundary consumed by the pipeline worker and the MCP server) is deliberately not part of this document; see docs/api/README.md."},"servers":[{"url":"https://api.valyzer.com"}],"tags":[{"name":"Meta"},{"name":"Events"},{"name":"Entities"},{"name":"Exposure & Impact"},{"name":"Map & World"},{"name":"Observatories"},{"name":"Account"},{"name":"Editorial"},{"name":"Client panel"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Supabase-issued user access token. Omit for endpoints marked `auth: optional`."}}},"paths":{"/v1/health":{"get":{"tags":["Meta"],"summary":"Service health","description":"Liveness probe. Always public, never rate-limited by identity.","security":[],"x-rate-limit-class":"public-read","parameters":[],"responses":{"200":{"description":"The service is up.","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"status":{"type":"string","const":"ok"},"timestamp":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"version":{"type":"string"}},"required":["service","status","timestamp","version"],"additionalProperties":false}}}}}}},"/v1/openapi.json":{"get":{"tags":["Meta"],"summary":"OpenAPI document","description":"This document, generated from `@valyzer/contracts`.","security":[],"x-rate-limit-class":"public-read","parameters":[],"responses":{"200":{"description":"OpenAPI 3.1 document."}}}},"/v1/docs":{"get":{"tags":["Meta"],"summary":"Human-readable API documentation","description":"A self-contained HTML page (no external scripts or stylesheets) rendering this spec.","security":[],"x-rate-limit-class":"public-read","parameters":[],"responses":{"200":{"description":"HTML documentation page."}}}},"/v1/events":{"get":{"tags":["Events"],"summary":"List published events","description":"Cursor-paginated, bitemporal event feed. Only `published` events are ever returned; `asOf`/`knownAt` select the valid-time and recorded-time cut, defaulting to now/latest.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["occurred","importance"]}},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["es","en"]}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]},{"type":"array","items":{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]}}]}},{"name":"severity","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["low","medium","high","critical"]},{"type":"array","items":{"type":"string","enum":["low","medium","high","critical"]}}]}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["draft","processing","ready","needs_review","published","rejected","failed","archived"]},{"type":"array","items":{"type":"string","enum":["draft","processing","ready","needs_review","published","rejected","failed","archived"]}}]}},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}]}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"array","items":{"type":"string","minLength":2,"maxLength":2}}]}},{"name":"occurredFrom","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"occurredTo","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"A page of events.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"source":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"language":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","title","url","publishedAt"],"additionalProperties":false},{"type":"null"}]},"excerpt":{"anyOf":[{"type":"string","maxLength":280},{"type":"null"}]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]},"family":{"default":"economic","type":"string","enum":["conflict","economic","political","infrastructure"]},"typeCode":{"default":"sanction","type":"string","maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},"status":{"type":"string","const":"published"},"severity":{"type":"string","enum":["low","medium","high","critical"]},"title":{"type":"string"},"summary":{"type":"string"},"occurrence":{"type":"object","properties":{"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["from","to"],"additionalProperties":false},"locations":{"type":"array","items":{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false}},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"verificationStatus":{"default":"verified","type":"string","enum":["provisional","verified"]},"verificationMethod":{"default":"human","type":"string","enum":["human","automated","hybrid"]},"qualityStatus":{"default":"clear","type":"string","enum":["clear","warning","disputed"]},"entities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]},"canonicalName":{"type":"string"}},"required":["id","kind","canonicalName"],"additionalProperties":false}},"claims":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}}},"required":["id","kind","statement","confidence","evidence"],"additionalProperties":false}},"relationships":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"fromEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"toEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"strength":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","fromEntityId","toEntityId","type","direction","strength","confidence","evidence","validFrom","validTo"],"additionalProperties":false}},"impacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"mechanism":{"type":"string"},"horizon":{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"outcomeClaimId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"reviewStatus":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]}},"required":["id","entityId","claimId","direction","mechanism","horizon","confidence","outcomeClaimId","evidence"],"additionalProperties":false}},"claimCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"entityCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"evidenceCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","type","family","typeCode","status","severity","title","summary","occurrence","locations","confidence","verificationStatus","verificationMethod","qualityStatus","entities","claims","relationships","impacts","updatedAt"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}}}}},"/v1/events/{id}":{"get":{"tags":["Events"],"summary":"Get a published event","description":"Full projection: entities, claims, relationships, impacts, evidence. `locale=en` drops Spanish-only evidence (WORLD_NEWS §7).","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["es","en"]}}],"responses":{"200":{"description":"The event.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"language":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","title","url","publishedAt"],"additionalProperties":false},{"type":"null"}]},"excerpt":{"anyOf":[{"type":"string","maxLength":280},{"type":"null"}]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]},"family":{"default":"economic","type":"string","enum":["conflict","economic","political","infrastructure"]},"typeCode":{"default":"sanction","type":"string","maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},"status":{"type":"string","const":"published"},"severity":{"type":"string","enum":["low","medium","high","critical"]},"title":{"type":"string"},"summary":{"type":"string"},"occurrence":{"type":"object","properties":{"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["from","to"],"additionalProperties":false},"locations":{"type":"array","items":{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false}},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"verificationStatus":{"default":"verified","type":"string","enum":["provisional","verified"]},"verificationMethod":{"default":"human","type":"string","enum":["human","automated","hybrid"]},"qualityStatus":{"default":"clear","type":"string","enum":["clear","warning","disputed"]},"entities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]},"canonicalName":{"type":"string"}},"required":["id","kind","canonicalName"],"additionalProperties":false}},"claims":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}}},"required":["id","kind","statement","confidence","evidence"],"additionalProperties":false}},"relationships":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"fromEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"toEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"strength":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","fromEntityId","toEntityId","type","direction","strength","confidence","evidence","validFrom","validTo"],"additionalProperties":false}},"impacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"mechanism":{"type":"string"},"horizon":{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"outcomeClaimId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"reviewStatus":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]}},"required":["id","entityId","claimId","direction","mechanism","horizon","confidence","outcomeClaimId","evidence"],"additionalProperties":false}},"claimCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"entityCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"evidenceCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","type","family","typeCode","status","severity","title","summary","occurrence","locations","confidence","verificationStatus","verificationMethod","qualityStatus","entities","claims","relationships","impacts","updatedAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"No published event with this id at the given cut.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/events/{id}/history":{"get":{"tags":["Events"],"summary":"Public revision history of an event","description":"The recorded-time revision timeline of a published event, without workspace or reviewer identity.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"A page of revisions.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"supersedesVersionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"kind":{"type":"string","enum":["publication","correction"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"recordedFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"recordedTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"title":{"type":"string"},"summary":{"type":"string"},"severity":{"type":"string","enum":["low","medium","high","critical"]},"occurrence":{"type":"object","properties":{"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["from","to"],"additionalProperties":false},"locations":{"type":"array","items":{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false}},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]}},"required":["eventId","versionId","supersedesVersionId","kind","reason","validFrom","validTo","recordedFrom","recordedTo","title","summary","severity","occurrence","locations","confidence"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}}}}},"/v1/events/{id}/evolution":{"get":{"tags":["Events"],"summary":"Public knowledge evolution for an event","description":"Paginated timeline of publications, corrections, claim resolutions and impact reviews at a reproducible bitemporal cut. Compares explicit version ids; restricted comparisons are marked unavailable instead of leaking editorial snapshots.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"A page of evolution entries with resolved clocks in meta.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["publication","event_correction","claim_resolution","impact_review"]},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"publicReason":{"anyOf":[{"type":"string","minLength":1,"maxLength":1000},{"type":"null"}]},"changes":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"targetType":{"type":"string","enum":["event","claim","impact"]},"targetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"beforeVersionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"afterVersionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"fields":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"field":{"type":"string","enum":["title","summary","severity","occurrence","locations","confidence"]},"before":{"anyOf":[{"type":"string"},{"type":"string","enum":["low","medium","high","critical"]},{"type":"object","properties":{"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["from","to"],"additionalProperties":false},{"type":"array","items":{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false}},{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},{"type":"null"}]},"after":{"anyOf":[{"type":"string"},{"type":"string","enum":["low","medium","high","critical"]},{"type":"object","properties":{"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["from","to"],"additionalProperties":false},{"type":"array","items":{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false}},{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},{"type":"null"}]}},"required":["field","before","after"],"additionalProperties":false},{"type":"object","properties":{"field":{"type":"string","enum":["statement","kind"]},"before":{"anyOf":[{"type":"string"},{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]}]},"after":{"anyOf":[{"type":"string"},{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]}]}},"required":["field","before","after"],"additionalProperties":false},{"type":"object","properties":{"field":{"type":"string","enum":["mechanism","direction","horizon","confidence","reviewStatus"]},"before":{"anyOf":[{"type":"string"},{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},{"type":"null"}]},"after":{"anyOf":[{"type":"string"},{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},{"type":"null"}]}},"required":["field","before","after"],"additionalProperties":false}]}},"evidenceAdded":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"evidenceRemoved":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"comparisonStatus":{"type":"string","enum":["available","unavailable"]}},"required":["targetType","targetId","beforeVersionId","afterVersionId","fields"],"additionalProperties":false}},"changesCursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["id","kind","recordedAt","validFrom","validTo","publicReason","changes"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false},"meta":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"knownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"partial":{"type":"boolean"}},"required":["asOf","knownAt","partial"],"additionalProperties":false}},"required":["data","page","meta"],"additionalProperties":false}}}}}}},"/v1/events/{id}/evolution/{changeId}/changes":{"get":{"tags":["Events"],"summary":"Paginated changes for one evolution entry","description":"Returns additional changes when an evolution entry exceeds the initial page size.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"changeId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"A page of typed before/after changes.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"targetType":{"type":"string","enum":["event","claim","impact"]},"targetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"beforeVersionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"afterVersionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"fields":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"field":{"type":"string","enum":["title","summary","severity","occurrence","locations","confidence"]},"before":{"anyOf":[{"type":"string"},{"type":"string","enum":["low","medium","high","critical"]},{"type":"object","properties":{"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["from","to"],"additionalProperties":false},{"type":"array","items":{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false}},{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},{"type":"null"}]},"after":{"anyOf":[{"type":"string"},{"type":"string","enum":["low","medium","high","critical"]},{"type":"object","properties":{"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["from","to"],"additionalProperties":false},{"type":"array","items":{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false}},{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},{"type":"null"}]}},"required":["field","before","after"],"additionalProperties":false},{"type":"object","properties":{"field":{"type":"string","enum":["statement","kind"]},"before":{"anyOf":[{"type":"string"},{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]}]},"after":{"anyOf":[{"type":"string"},{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]}]}},"required":["field","before","after"],"additionalProperties":false},{"type":"object","properties":{"field":{"type":"string","enum":["mechanism","direction","horizon","confidence","reviewStatus"]},"before":{"anyOf":[{"type":"string"},{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},{"type":"null"}]},"after":{"anyOf":[{"type":"string"},{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},{"type":"null"}]}},"required":["field","before","after"],"additionalProperties":false}]}},"evidenceAdded":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"evidenceRemoved":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"comparisonStatus":{"type":"string","enum":["available","unavailable"]}},"required":["targetType","targetId","beforeVersionId","afterVersionId","fields"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false},"meta":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"knownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"partial":{"type":"boolean"}},"required":["asOf","knownAt","partial"],"additionalProperties":false}},"required":["data","page","meta"],"additionalProperties":false}}}}}}},"/v1/events/{id}/corrections":{"post":{"tags":["Events"],"summary":"Submit an editorial correction","description":"Reviewer/admin only, restricted to the configured editorial workspace. Closes the current event version's recorded interval and appends its successor atomically; preserves valid time. A patch with no effective change is rejected with 409.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"reason":{"type":"string","minLength":1,"maxLength":2000},"patch":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":300},"summary":{"type":"string","minLength":1,"maxLength":5000},"severity":{"type":"string","enum":["low","medium","high","critical"]},"occurrence":{"type":"object","properties":{"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["from","to"]},"locations":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"]}},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]}}}},"required":["workspaceId","reason","patch"]}}}},"responses":{"201":{"description":"Correction recorded.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"correctionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["correctionId","eventId","versionId","recordedAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"403":{"description":"Not a reviewer/admin of the editorial workspace.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"The patch produces no effective change.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/editorial/conflicts":{"post":{"tags":["Editorial"],"summary":"Register a claim conflict","description":"Admin-only in the configured editorial workspace. Creates an auditable conflict between two stored claim versions and records an opening decision.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"leftClaimVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"rightClaimVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["incompatible_assertions","scope_mismatch"]},"scopeNote":{"type":"string","minLength":1,"maxLength":2000}},"required":["requestId","eventId","leftClaimVersionId","rightClaimVersionId","kind","scopeNote"]}}}},"responses":{"201":{"description":"Conflict registered.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"leftClaimVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"rightClaimVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["incompatible_assertions","scope_mismatch"]},"scopeNote":{"type":"string","minLength":1,"maxLength":2000},"status":{"type":"string","enum":["open","resolved"]},"revision":{"type":"integer","minimum":1,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"resolvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolutionDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","workspaceId","eventId","leftClaimVersionId","rightClaimVersionId","kind","scopeNote","status","revision","createdAt","resolvedAt","resolutionDecisionId"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"409":{"description":"Duplicate pair or idempotency conflict.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}},"get":{"tags":["Editorial"],"summary":"List claim conflicts","description":"Admin-only paginated list of open or resolved conflicts in the editorial workspace.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"status","in":"query","required":false,"schema":{"default":"open","type":"string","enum":["open","resolved"]}},{"name":"eventId","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"A page of conflicts.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"leftClaimVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"rightClaimVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["incompatible_assertions","scope_mismatch"]},"scopeNote":{"type":"string","minLength":1,"maxLength":2000},"status":{"type":"string","enum":["open","resolved"]},"revision":{"type":"integer","minimum":1,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"resolvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolutionDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","workspaceId","eventId","leftClaimVersionId","rightClaimVersionId","kind","scopeNote","status","revision","createdAt","resolvedAt","resolutionDecisionId"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}}}}},"/v1/editorial/conflicts/{id}":{"get":{"tags":["Editorial"],"summary":"Get a claim conflict with decisions","description":"Admin-only detail view with both claim sides, authorized evidence, and paginated decisions.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Conflict detail.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"leftClaimVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"rightClaimVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["incompatible_assertions","scope_mismatch"]},"scopeNote":{"type":"string","minLength":1,"maxLength":2000},"status":{"type":"string","enum":["open","resolved"]},"revision":{"type":"integer","minimum":1,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"resolvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolutionDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"left":{"type":"object","properties":{"claim":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}}},"required":["id","kind","statement","confidence","evidence"],"additionalProperties":false},"version":{"type":"object","properties":{"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"recordedFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"recordedTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["versionId","claimId","eventId","kind","statement","confidence","validFrom","validTo","recordedFrom","recordedTo"],"additionalProperties":false}},"required":["claim","version"],"additionalProperties":false},"right":{"type":"object","properties":{"claim":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}}},"required":["id","kind","statement","confidence","evidence"],"additionalProperties":false},"version":{"type":"object","properties":{"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"recordedFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"recordedTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["versionId","claimId","eventId","kind","statement","confidence","validFrom","validTo","recordedFrom","recordedTo"],"additionalProperties":false}},"required":["claim","version"],"additionalProperties":false},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"actorId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"actorType":{"type":"string","enum":["user","service"]},"action":{"type":"string","minLength":1,"maxLength":200},"targetType":{"type":"string","minLength":1,"maxLength":100},"targetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"payloadHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"reason":{"type":"string","minLength":1,"maxLength":2000},"publicReason":{"anyOf":[{"type":"string","minLength":1,"maxLength":1000},{"type":"null"}]},"beforeRefs":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["claim","claim_version","event","conflict","relationship","entity","entity_version","equivalence","impact","impact_version"]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["type","id","versionId"],"additionalProperties":false}},"afterRefs":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["claim","claim_version","event","conflict","relationship","entity","entity_version","equivalence","impact","impact_version"]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["type","id","versionId"],"additionalProperties":false}},"reversesDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","workspaceId","actorId","actorType","action","targetType","targetId","requestId","payloadHash","recordedAt","reason","publicReason","beforeRefs","afterRefs","reversesDecisionId"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["id","workspaceId","eventId","leftClaimVersionId","rightClaimVersionId","kind","scopeNote","status","revision","createdAt","resolvedAt","resolutionDecisionId","left","right","decisions","page"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Conflict not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/editorial/conflicts/{id}/resolve":{"post":{"tags":["Editorial"],"summary":"Resolve a claim conflict","description":"Admin-only resolution with optimistic concurrency on revision and premise versions.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedRevision":{"type":"integer","minimum":1,"maximum":9007199254740991},"expectedLeftVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedRightVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"action":{"type":"string","enum":["keep_both","supersede_left","reject_right"]},"reason":{"type":"string","minLength":1,"maxLength":2000},"publicReason":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":1000},{"type":"null"}]}},"required":["requestId","expectedRevision","expectedLeftVersionId","expectedRightVersionId","action","reason"]}}}},"responses":{"200":{"description":"Conflict resolved.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"conflictId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","minimum":1,"maximum":9007199254740991},"decisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["conflictId","revision","decisionId","recordedAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"409":{"description":"Already resolved or stale revision.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Semantic rejection (publication gate, validity, correction flow).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/editorial/entities/merge-preview":{"post":{"tags":["Editorial"],"summary":"Preview an entity identity merge","description":"Admin-only read of expected versions, affected counts, incompatibilities, and a preview token.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sourceEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["sourceEntityId","canonicalEntityId"]}}}},"responses":{"200":{"description":"Merge preview generated.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"sourceEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedSourceVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedCanonicalVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"relationshipCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"claimCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"impactCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"incompatibilities":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["different_kind","different_workspace","private_public_mix","existing_equivalence","would_cycle"]},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"previewToken":{"type":"string","minLength":1}},"required":["sourceEntityId","canonicalEntityId","expectedSourceVersionId","expectedCanonicalVersionId","relationshipCount","claimCount","impactCount","incompatibilities","previewToken"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}}}},"/v1/editorial/entities/merge":{"post":{"tags":["Editorial"],"summary":"Merge duplicate entity identities","description":"Admin-only merge with preview token validation and auditable equivalence redirect.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"previewToken":{"type":"string","minLength":1},"expectedSourceVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedCanonicalVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"reason":{"type":"string","minLength":1,"maxLength":2000},"publicReason":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":1000},{"type":"null"}]}},"required":["requestId","previewToken","expectedSourceVersionId","expectedCanonicalVersionId","reason"]}}}},"responses":{"201":{"description":"Merge recorded.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"decisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"equivalenceVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["decisionId","equivalenceVersionId","recordedAt","validFrom","validTo"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"409":{"description":"Stale preview or idempotency conflict.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Unsupported identity group or validity mismatch.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/editorial/entity-decisions/{id}/revert":{"post":{"tags":["Editorial"],"summary":"Revert an entity merge decision","description":"Admin-only compensating decision that closes the equivalence redirect.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedEquivalenceVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"reason":{"type":"string","minLength":1,"maxLength":2000},"publicReason":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":1000},{"type":"null"}]}},"required":["requestId","expectedEquivalenceVersionId","reason"]}}}},"responses":{"200":{"description":"Revert recorded.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"decisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"equivalenceVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["decisionId","equivalenceVersionId","recordedAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"409":{"description":"Stale equivalence or dependent identity change.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/editorial/entities/{id}/decisions":{"get":{"tags":["Editorial"],"summary":"List entity identity decisions","description":"Admin-only paginated history of merge decisions for an entity with revert eligibility.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"A page of identity decisions.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"decision":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"actorId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"actorType":{"type":"string","enum":["user","service"]},"action":{"type":"string","minLength":1,"maxLength":200},"targetType":{"type":"string","minLength":1,"maxLength":100},"targetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"payloadHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"reason":{"type":"string","minLength":1,"maxLength":2000},"publicReason":{"anyOf":[{"type":"string","minLength":1,"maxLength":1000},{"type":"null"}]},"beforeRefs":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["claim","claim_version","event","conflict","relationship","entity","entity_version","equivalence","impact","impact_version"]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["type","id","versionId"],"additionalProperties":false}},"afterRefs":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["claim","claim_version","event","conflict","relationship","entity","entity_version","equivalence","impact","impact_version"]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["type","id","versionId"],"additionalProperties":false}},"reversesDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","workspaceId","actorId","actorType","action","targetType","targetId","requestId","payloadHash","recordedAt","reason","publicReason","beforeRefs","afterRefs","reversesDecisionId"],"additionalProperties":false},"before":{"type":"object","properties":{"sourceEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"equivalenceVersionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["sourceEntityId","canonicalEntityId","equivalenceVersionId"],"additionalProperties":false},"after":{"type":"object","properties":{"sourceEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"equivalenceVersionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["sourceEntityId","canonicalEntityId","equivalenceVersionId"],"additionalProperties":false},"revertible":{"type":"boolean"},"revertBlockedReason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["decision","before","after","revertible","revertBlockedReason"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}}}}},"/v1/editorial/predicate-proposals":{"post":{"tags":["Editorial"],"summary":"Propose a new predicate","description":"Admin-only vocabulary proposal with authorized examples. Does not relax runtime catalog validation.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"proposedCode":{"type":"string","maxLength":120,"pattern":"^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)+$"},"form":{"type":"string","enum":["observation","state","event","edge","identity","geometry","derived"]},"unit":{"anyOf":[{"type":"string","minLength":1,"maxLength":50},{"type":"null"}]},"valueType":{"type":"string","enum":["number","string","boolean","none"]},"description":{"type":"string","minLength":1,"maxLength":2000},"examples":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"claimVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["claimVersionId","sourceDocumentId"]}},"destination":{}},"required":["requestId","proposedCode","form","unit","valueType","description","examples"]}}}},"responses":{"201":{"description":"Proposal recorded.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"proposedCode":{"type":"string","maxLength":120,"pattern":"^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)+$"},"form":{"type":"string","enum":["observation","state","event","edge","identity","geometry","derived"]},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]},"valueType":{"type":"string","enum":["number","string","boolean","none"]},"description":{"type":"string","minLength":1,"maxLength":2000},"status":{"type":"string","enum":["proposed","accepted","rejected","implemented"]},"revision":{"type":"integer","minimum":1,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"decisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"catalogVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"supersedesProposalId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","workspaceId","proposedCode","form","unit","valueType","description","status","revision","createdAt","decisionId","catalogVersion","supersedesProposalId"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"422":{"description":"Predicate already exists or invalid proposal shape.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}},"get":{"tags":["Editorial"],"summary":"List predicate proposals","description":"Admin-only paginated list filtered by status (default proposed).","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"status","in":"query","required":false,"schema":{"default":"proposed","type":"string","enum":["proposed","accepted","rejected","implemented"]}}],"responses":{"200":{"description":"A page of predicate proposals.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"proposedCode":{"type":"string","maxLength":120,"pattern":"^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)+$"},"form":{"type":"string","enum":["observation","state","event","edge","identity","geometry","derived"]},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]},"valueType":{"type":"string","enum":["number","string","boolean","none"]},"description":{"type":"string","minLength":1,"maxLength":2000},"status":{"type":"string","enum":["proposed","accepted","rejected","implemented"]},"revision":{"type":"integer","minimum":1,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"decisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"catalogVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"supersedesProposalId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","workspaceId","proposedCode","form","unit","valueType","description","status","revision","createdAt","decisionId","catalogVersion","supersedesProposalId"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}}}}},"/v1/editorial/predicate-proposals/{id}":{"get":{"tags":["Editorial"],"summary":"Get predicate proposal detail","description":"Admin-only detail with up to 20 examples and paginated decisions.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Proposal detail.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"proposedCode":{"type":"string","maxLength":120,"pattern":"^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)+$"},"form":{"type":"string","enum":["observation","state","event","edge","identity","geometry","derived"]},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]},"valueType":{"type":"string","enum":["number","string","boolean","none"]},"description":{"type":"string","minLength":1,"maxLength":2000},"status":{"type":"string","enum":["proposed","accepted","rejected","implemented"]},"revision":{"type":"integer","minimum":1,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"decisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"catalogVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"supersedesProposalId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"destination":{"anyOf":[{},{"type":"null"}]},"coverage":{"type":"object","properties":{"documentCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"rootCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"acceptThresholdMet":{"type":"boolean"}},"required":["documentCount","rootCount","acceptThresholdMet"],"additionalProperties":false},"suggestedPredicate":{"type":"string"},"examples":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"proposalId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"editorialRoot":{"type":"string","minLength":1,"maxLength":500}},"required":["proposalId","claimVersionId","sourceDocumentId","editorialRoot"],"additionalProperties":false}},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"actorId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"actorType":{"type":"string","enum":["user","service"]},"action":{"type":"string","minLength":1,"maxLength":200},"targetType":{"type":"string","minLength":1,"maxLength":100},"targetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"payloadHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"reason":{"type":"string","minLength":1,"maxLength":2000},"publicReason":{"anyOf":[{"type":"string","minLength":1,"maxLength":1000},{"type":"null"}]},"beforeRefs":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["claim","claim_version","event","conflict","relationship","entity","entity_version","equivalence","impact","impact_version"]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["type","id","versionId"],"additionalProperties":false}},"afterRefs":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["claim","claim_version","event","conflict","relationship","entity","entity_version","equivalence","impact","impact_version"]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["type","id","versionId"],"additionalProperties":false}},"reversesDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","workspaceId","actorId","actorType","action","targetType","targetId","requestId","payloadHash","recordedAt","reason","publicReason","beforeRefs","afterRefs","reversesDecisionId"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["id","workspaceId","proposedCode","form","unit","valueType","description","status","revision","createdAt","decisionId","catalogVersion","supersedesProposalId","destination","coverage","examples","decisions","page"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/editorial/predicate-proposals/{id}/decide":{"post":{"tags":["Editorial"],"summary":"Accept or reject a predicate proposal","description":"Admin-only decision with coverage threshold on accept (3 documents, 2 roots).","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedRevision":{"type":"integer","minimum":1,"maximum":9007199254740991},"action":{"type":"string","enum":["accept","reject"]},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["requestId","expectedRevision","action","reason"]}}}},"responses":{"200":{"description":"Decision recorded.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"proposalId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","minimum":1,"maximum":9007199254740991},"status":{"type":"string","enum":["proposed","accepted","rejected","implemented"]},"decisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["proposalId","revision","status","decisionId","recordedAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"422":{"description":"Insufficient example coverage for acceptance.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/editorial/predicate-proposals/{id}/mark-implemented":{"post":{"tags":["Editorial"],"summary":"Mark proposal implemented after catalog deploy","description":"Admin-only closure once the deployed catalog contains an exact matching entry.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedRevision":{"type":"integer","minimum":1,"maximum":9007199254740991},"catalogVersion":{"type":"string","minLength":1,"maxLength":40},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["requestId","expectedRevision","catalogVersion","reason"]}}}},"responses":{"200":{"description":"Implementation recorded.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"proposalId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","minimum":1,"maximum":9007199254740991},"status":{"type":"string","const":"implemented"},"decisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"catalogVersion":{"type":"string"},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["proposalId","revision","status","decisionId","catalogVersion","recordedAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"409":{"description":"Catalog version or entry not deployed.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/editorial/impacts/review-queue":{"get":{"tags":["Editorial"],"summary":"List impacts pending review","description":"Admin-only paginated queue of impacts marked needs_review or legacy_untracked.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"status","in":"query","required":false,"schema":{"default":"needs_review","type":"string","enum":["needs_review","legacy_untracked"]}}],"responses":{"200":{"description":"A page of impacts awaiting review.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"impactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"impactVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"mechanism":{"type":"string"},"horizon":{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},"status":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},"reasonDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"recordedFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["impactId","impactVersionId","eventId","entityId","claimId","direction","mechanism","horizon","status","reasonDecisionId","validFrom","validTo","recordedFrom"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}}}}},"/v1/editorial/impacts/{id}/review":{"post":{"tags":["Editorial"],"summary":"Review an impact derivation","description":"Admin-only attach, reaffirm, or withdraw with optimistic concurrency on impact and premise versions.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedImpactVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"action":{"type":"string","enum":["attach","reaffirm","withdraw"]},"reason":{"type":"string","minLength":1,"maxLength":2000},"publicReason":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":1000},{"type":"null"}]},"derivation":{"type":"object","properties":{"methodCode":{"default":"editorial_exposure_chain","type":"string","const":"editorial_exposure_chain"},"methodVersion":{"default":"1","type":"string","const":"1"},"explanation":{"type":"string","minLength":1,"maxLength":2000},"premises":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"targetType":{"type":"string","enum":["claim","relationship","entity"]},"targetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"targetVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"role":{"type":"string","enum":["triggering_fact","exposure_link","identity"]},"ordinal":{"type":"integer","minimum":0,"maximum":49}},"required":["targetType","targetId","targetVersionId","role","ordinal"]}}},"required":["explanation","premises"]}},"required":["requestId","expectedImpactVersionId","action","reason"]}}}},"responses":{"200":{"description":"Review recorded.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"decisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"impactVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]}},"required":["decisionId","impactVersionId","recordedAt","status"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"409":{"description":"Stale revision or idempotency conflict.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Invalid derivation or publication gate failure.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/impacts/{id}/explanation":{"get":{"tags":["Impacts"],"summary":"Public impact explanation","description":"Returns the authorized premise chain for an impact at the requested temporal cut.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"Impact explanation projection.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"impactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"impactVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},"method":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},"version":{"type":"string","minLength":1,"maxLength":40}},"required":["code","version"],"additionalProperties":false},{"type":"null"}]},"explanation":{"anyOf":[{"type":"string"},{"type":"null"}]},"premises":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["claim","relationship","entity"]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"role":{"type":"string","enum":["triggering_fact","exposure_link","identity"]},"projection":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["type","id","versionId","role","projection"],"additionalProperties":false}},"completeness":{"type":"string","enum":["complete","restricted","legacy"]}},"required":["impactId","impactVersionId","status","method","explanation","premises","completeness"],"additionalProperties":false},"meta":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"knownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["asOf","knownAt"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"404":{"description":"Impact not found or withdrawn at current cut.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/entities":{"get":{"tags":["Entities"],"summary":"List entities","description":"Cursor-paginated entity list with kind and free-text filters. `statePredicate` (a catalog predicate of form `state`, e.g. `sanctions.designation`) restricts to subjects of a currently public State at the requested asOf/knownAt — '¿quién está designado a T?' (docs/data/STATE_FORM.md §7); `stateValue` narrows to one coexisting value (a regime's entity uuid, or literal text).","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]},{"type":"array","items":{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]}}]}},{"name":"query","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"statePredicate","in":"query","required":false,"schema":{"type":"string","maxLength":120,"pattern":"^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)+$"}},{"name":"stateValue","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":300}}],"responses":{"200":{"description":"A page of entities.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]},"canonicalName":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"aliasContributions":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"originEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["value","originEntityId"],"additionalProperties":false}},"requestedEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"identityDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"geography":{"anyOf":[{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false},{"type":"null"}]},"states":{"type":"array","items":{"type":"object","properties":{"predicate":{"type":"string"},"coexistenceKey":{"type":"string"},"value":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"entity"},"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalName":{"type":"string"}},"required":["kind","entityId","canonicalName"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["string","boolean"]},"text":{"type":"string"}},"required":["kind","text"],"additionalProperties":false}]},"attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["predicate","coexistenceKey","value","attributes","validFrom","validTo","sourceDocumentId"],"additionalProperties":false}},"relationships":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"fromEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"toEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"strength":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","fromEntityId","toEntityId","type","direction","strength","confidence","evidence","validFrom","validTo"],"additionalProperties":false}},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]},"severity":{"type":"string","enum":["low","medium","high","critical"]},"title":{"type":"string"},"occurredAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","type","severity","title","occurredAt"],"additionalProperties":false}},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","kind","canonicalName","aliases","geography","relationships","events","updatedAt"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}}}}},"/v1/entities/{id}":{"get":{"tags":["Entities"],"summary":"Get an entity","description":"Full projection: relationships and linked events.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"The entity.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]},"canonicalName":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"aliasContributions":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"originEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["value","originEntityId"],"additionalProperties":false}},"requestedEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"identityDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"geography":{"anyOf":[{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false},{"type":"null"}]},"states":{"type":"array","items":{"type":"object","properties":{"predicate":{"type":"string"},"coexistenceKey":{"type":"string"},"value":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"entity"},"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalName":{"type":"string"}},"required":["kind","entityId","canonicalName"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["string","boolean"]},"text":{"type":"string"}},"required":["kind","text"],"additionalProperties":false}]},"attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["predicate","coexistenceKey","value","attributes","validFrom","validTo","sourceDocumentId"],"additionalProperties":false}},"relationships":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"fromEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"toEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"strength":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","fromEntityId","toEntityId","type","direction","strength","confidence","evidence","validFrom","validTo"],"additionalProperties":false}},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]},"severity":{"type":"string","enum":["low","medium","high","critical"]},"title":{"type":"string"},"occurredAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","type","severity","title","occurredAt"],"additionalProperties":false}},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","kind","canonicalName","aliases","geography","relationships","events","updatedAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"No entity with this id.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/companies/{id}/exposure":{"get":{"tags":["Exposure & Impact"],"summary":"Company exposure","description":"Impacts targeting this company (fact, mechanism, direction, confidence, and evidence per claim) plus its relationships to other entities. 404 if the id is not a company.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"The company's exposure.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entity":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]},"canonicalName":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"aliasContributions":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"originEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["value","originEntityId"],"additionalProperties":false}},"requestedEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"identityDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"geography":{"anyOf":[{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false},{"type":"null"}]}},"required":["id","kind","canonicalName","aliases","geography"],"additionalProperties":false},"impacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"mechanism":{"type":"string"},"horizon":{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"outcomeClaimId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"reviewStatus":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},"claim":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}}},"required":["id","kind","statement","confidence","evidence"],"additionalProperties":false},"event":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string"},"family":{"type":"string","enum":["conflict","economic","political","infrastructure"]},"typeCode":{"type":"string","maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},"severity":{"type":"string","enum":["low","medium","high","critical"]},"occurredFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","title","family","typeCode","severity","occurredFrom"],"additionalProperties":false}},"required":["id","entityId","claimId","direction","mechanism","horizon","confidence","outcomeClaimId","evidence","claim","event"],"additionalProperties":false}},"relationships":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"fromEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"toEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"strength":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","fromEntityId","toEntityId","type","direction","strength","confidence","evidence","validFrom","validTo"],"additionalProperties":false}},"meta":{"type":"object","properties":{"asOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"knownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["asOf","knownAt"],"additionalProperties":false}},"required":["entity","impacts","relationships","meta"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"No company with this id.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/sectors/{id}/exposure":{"get":{"tags":["Exposure & Impact"],"summary":"Sector exposure","description":"Same shape as company exposure, scoped to a sector entity. 404 if the id is not a sector.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"The sector's exposure.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entity":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]},"canonicalName":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"aliasContributions":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"originEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["value","originEntityId"],"additionalProperties":false}},"requestedEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"identityDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"geography":{"anyOf":[{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false},{"type":"null"}]}},"required":["id","kind","canonicalName","aliases","geography"],"additionalProperties":false},"impacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"mechanism":{"type":"string"},"horizon":{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"outcomeClaimId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"reviewStatus":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},"claim":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}}},"required":["id","kind","statement","confidence","evidence"],"additionalProperties":false},"event":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string"},"family":{"type":"string","enum":["conflict","economic","political","infrastructure"]},"typeCode":{"type":"string","maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},"severity":{"type":"string","enum":["low","medium","high","critical"]},"occurredFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","title","family","typeCode","severity","occurredFrom"],"additionalProperties":false}},"required":["id","entityId","claimId","direction","mechanism","horizon","confidence","outcomeClaimId","evidence","claim","event"],"additionalProperties":false}},"relationships":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"fromEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"toEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"strength":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","fromEntityId","toEntityId","type","direction","strength","confidence","evidence","validFrom","validTo"],"additionalProperties":false}},"meta":{"type":"object","properties":{"asOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"knownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["asOf","knownAt"],"additionalProperties":false}},"required":["entity","impacts","relationships","meta"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"No sector with this id.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/commodities/{id}/risk":{"get":{"tags":["Exposure & Impact"],"summary":"Commodity risk","description":"Same shape as company exposure, scoped to a commodity entity -- the wedge's first link (`sanction -> commodity`, `docs/product/MOAT_STRATEGY.md` §4). 404 if the id is not a commodity.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"The commodity's risk exposure.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entity":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]},"canonicalName":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"aliasContributions":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"originEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["value","originEntityId"],"additionalProperties":false}},"requestedEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"identityDecisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"geography":{"anyOf":[{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false},{"type":"null"}]}},"required":["id","kind","canonicalName","aliases","geography"],"additionalProperties":false},"impacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"mechanism":{"type":"string"},"horizon":{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"outcomeClaimId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"reviewStatus":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},"claim":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}}},"required":["id","kind","statement","confidence","evidence"],"additionalProperties":false},"event":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string"},"family":{"type":"string","enum":["conflict","economic","political","infrastructure"]},"typeCode":{"type":"string","maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},"severity":{"type":"string","enum":["low","medium","high","critical"]},"occurredFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","title","family","typeCode","severity","occurredFrom"],"additionalProperties":false}},"required":["id","entityId","claimId","direction","mechanism","horizon","confidence","outcomeClaimId","evidence","claim","event"],"additionalProperties":false}},"relationships":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"fromEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"toEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"strength":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","fromEntityId","toEntityId","type","direction","strength","confidence","evidence","validFrom","validTo"],"additionalProperties":false}},"meta":{"type":"object","properties":{"asOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"knownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["asOf","knownAt"],"additionalProperties":false}},"required":["entity","impacts","relationships","meta"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"No commodity with this id.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/impact":{"get":{"tags":["Exposure & Impact"],"summary":"Global impact feed","description":"Cursor-paginated feed of every public impact, each enriched with its claim, event, and target entity. Filterable by entity id and direction.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}]}},{"name":"direction","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},{"type":"array","items":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]}}]}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"A page of impacts.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"mechanism":{"type":"string"},"horizon":{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"outcomeClaimId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"reviewStatus":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},"claim":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}}},"required":["id","kind","statement","confidence","evidence"],"additionalProperties":false},"event":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string"},"family":{"type":"string","enum":["conflict","economic","political","infrastructure"]},"typeCode":{"type":"string","maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},"severity":{"type":"string","enum":["low","medium","high","critical"]},"occurredFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","title","family","typeCode","severity","occurredFrom"],"additionalProperties":false},"entity":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]},"canonicalName":{"type":"string"}},"required":["id","kind","canonicalName"],"additionalProperties":false}},"required":["id","entityId","claimId","direction","mechanism","horizon","confidence","outcomeClaimId","evidence","claim","event","entity"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}}}}},"/v1/changes":{"get":{"tags":["Exposure & Impact"],"summary":"Bitemporal changes to the impact layer","description":"What changed in what we knew between two recorded-time instants -- not what happened (`/v1/events`). `since` is required; `until` defaults to request time and is always echoed back in `meta.until` rather than left implicit.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"since","in":"query","required":true,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"until","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"A page of changes.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["added","removed"]},"changedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"impact":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"mechanism":{"type":"string"},"horizon":{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"outcomeClaimId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"reviewStatus":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},"claim":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}}},"required":["id","kind","statement","confidence","evidence"],"additionalProperties":false},"event":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string"},"family":{"type":"string","enum":["conflict","economic","political","infrastructure"]},"typeCode":{"type":"string","maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},"severity":{"type":"string","enum":["low","medium","high","critical"]},"occurredFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","title","family","typeCode","severity","occurredFrom"],"additionalProperties":false},"entity":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]},"canonicalName":{"type":"string"}},"required":["id","kind","canonicalName"],"additionalProperties":false}},"required":["id","entityId","claimId","direction","mechanism","horizon","confidence","outcomeClaimId","evidence","claim","event","entity"],"additionalProperties":false}},"required":["kind","changedAt","impact"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false},"meta":{"type":"object","properties":{"since":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"until":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["since","until"],"additionalProperties":false}},"required":["data","page","meta"],"additionalProperties":false}}}},"400":{"description":"`until` precedes `since`.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/map/events":{"get":{"tags":["Map & World"],"summary":"List events within a bounding box","description":"The same event filters as `/v1/events`, scoped to a `west,south,east,north` viewport.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["occurred","importance"]}},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["es","en"]}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]},{"type":"array","items":{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]}}]}},{"name":"severity","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["low","medium","high","critical"]},{"type":"array","items":{"type":"string","enum":["low","medium","high","critical"]}}]}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["draft","processing","ready","needs_review","published","rejected","failed","archived"]},{"type":"array","items":{"type":"string","enum":["draft","processing","ready","needs_review","published","rejected","failed","archived"]}}]}},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}]}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"array","items":{"type":"string","minLength":2,"maxLength":2}}]}},{"name":"occurredFrom","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"occurredTo","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"west","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"south","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"east","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"north","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90}}],"responses":{"200":{"description":"A page of events.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]},"family":{"default":"economic","type":"string","enum":["conflict","economic","political","infrastructure"]},"typeCode":{"default":"sanction","type":"string","maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},"severity":{"type":"string","enum":["low","medium","high","critical"]},"title":{"type":"string"},"occurrence":{"type":"object","properties":{"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["from","to"],"additionalProperties":false},"locations":{"type":"array","items":{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false}},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"verificationStatus":{"default":"verified","type":"string","enum":["provisional","verified"]},"verificationMethod":{"default":"human","type":"string","enum":["human","automated","hybrid"]},"qualityStatus":{"default":"clear","type":"string","enum":["clear","warning","disputed"]}},"required":["id","type","family","typeCode","severity","title","occurrence","locations","confidence","verificationStatus","verificationMethod","qualityStatus"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}}}}},"/v1/world/features":{"get":{"tags":["Map & World"],"summary":"GeoJSON feature collection for the World map","description":"Composite layer (`events`, `situations`, `countries`) for one viewport and zoom level. Area layers answer on valid time (`asOf`) so the map can reconstruct a past date.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"bbox","in":"query","required":true,"schema":{"type":"string","pattern":"^-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?$"}},{"name":"zoom","in":"query","required":false,"schema":{"default":2,"type":"number","minimum":0,"maximum":24}},{"name":"layers","in":"query","required":false,"schema":{"default":"events,situations,countries","type":"string"}},{"name":"locale","in":"query","required":false,"schema":{"default":"en","type":"string","enum":["es","en"]}},{"name":"types","in":"query","required":false,"schema":{"type":"string"}},{"name":"severity","in":"query","required":false,"schema":{"type":"string"}},{"name":"situation","in":"query","required":false,"schema":{"type":"string"}},{"name":"resource","in":"query","required":false,"schema":{"type":"string","enum":["oil","natural_gas","coal","uranium","wheat","maize","nitrogen_fertilizer","phosphate_fertilizer","potash"]}},{"name":"verification","in":"query","required":false,"schema":{"type":"string","enum":["provisional","verified"]}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"A GeoJSON FeatureCollection.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"FeatureCollection"},"features":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"Feature"},"id":{"anyOf":[{"type":"string"},{"type":"number"}]},"geometry":{"type":"object","properties":{"type":{"type":"string","enum":["Point","MultiPoint","LineString","MultiLineString","Polygon","MultiPolygon"]},"coordinates":{}},"required":["type","coordinates"],"additionalProperties":false},"properties":{"type":"object","properties":{"id":{"type":"string","minLength":1},"layer":{"type":"string","enum":["events","situations","countries","resources","relations","impacts"]},"title":{"type":"string","minLength":1},"family":{"default":null,"anyOf":[{"type":"string","enum":["conflict","economic","political","infrastructure"]},{"type":"null"}]},"typeCode":{"default":null,"anyOf":[{"type":"string","maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},{"type":"null"}]},"severity":{"default":null,"anyOf":[{"type":"string","enum":["low","medium","high","critical"]},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"verificationStatus":{"type":"string","enum":["provisional","verified"]},"verificationMethod":{"type":"string","enum":["human","automated","hybrid"]},"qualityStatus":{"default":"clear","type":"string","enum":["clear","warning","disputed"]},"occurredFrom":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"situationSlug":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"resourceCode":{"default":null,"anyOf":[{"type":"string","enum":["oil","natural_gas","coal","uranium","wheat","maize","nitrogen_fertilizer","phosphate_fertilizer","potash"]},{"type":"null"}]},"inferred":{"default":false,"type":"boolean"},"countryIso2":{"default":null,"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"boundaryPolicy":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"situations":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string","minLength":1},"type":{"type":"string","enum":["armed_conflict","geopolitical_confrontation","crisis","sanctions_regime"]},"title":{"type":"string","minLength":1},"summary":{"type":"string"},"severity":{"type":"string","enum":["low","medium","high","critical"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"verificationStatus":{"type":"string","enum":["provisional","verified"]},"verificationMethod":{"type":"string","enum":["human","automated","hybrid"]},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"fatalities":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","slug","type","title","summary","severity","confidence","verificationStatus","verificationMethod","validFrom","validTo","fatalities"],"additionalProperties":false}}},"required":["id","layer","title","family","typeCode","severity","confidence","verificationStatus","verificationMethod","qualityStatus","occurredFrom","situationSlug","resourceCode","inferred","countryIso2","boundaryPolicy","situations"],"additionalProperties":false}},"required":["type","geometry","properties"],"additionalProperties":false}},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"asOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"knownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"cluster":{"type":"boolean"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["generatedAt","asOf","knownAt","cluster","nextCursor"],"additionalProperties":false}},"required":["type","features","meta"],"additionalProperties":false}}}}}}},"/v1/world/annual":{"get":{"tags":["Map & World"],"summary":"Annual layer catalogue or series","description":"Without `layer`, returns the catalogue of published annual series. With `layer`, returns the full `from..to` window in one payload so the client can scrub years without one request per year. Optional `knownAt` selects the recorded-time cut; absent, the series is current knowledge.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"layer","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z_]+(:[a-z_]+)?$"}},{"name":"from","in":"query","required":false,"schema":{"default":2000,"type":"integer","minimum":1800,"maximum":2200}},{"name":"to","in":"query","required":false,"schema":{"type":"integer","minimum":1800,"maximum":2200}},{"name":"locale","in":"query","required":false,"schema":{"default":"en","type":"string","enum":["es","en"]}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"Catalogue or series, depending on `layer`.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"layer":{"type":"string","pattern":"^[a-z_]+(:[a-z_]+)?$"},"family":{"type":"string","minLength":1},"metric":{"anyOf":[{"type":"string","enum":["reserves","production","consumption","imports","exports","dependency","bilateral_flow"]},{"type":"null"}]},"name":{"type":"object","properties":{"es":{"type":"string"},"en":{"type":"string"}},"required":["es","en"],"additionalProperties":false},"unit":{"type":"string","minLength":1},"direction":{"anyOf":[{"type":"string","enum":["higher_is_worse","higher_is_better"]},{"type":"null"}]},"from":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"to":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"countries":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["layer","family","metric","name","unit","direction","from","to","countries"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false},{"type":"object","properties":{"data":{"type":"object","properties":{"layer":{"type":"string","pattern":"^[a-z_]+(:[a-z_]+)?$"},"metric":{"anyOf":[{"type":"string","enum":["reserves","production","consumption","imports","exports","dependency","bilateral_flow"]},{"type":"null"}]},"name":{"type":"object","properties":{"es":{"type":"string"},"en":{"type":"string"}},"required":["es","en"],"additionalProperties":false},"unit":{"type":"string","minLength":1},"direction":{"anyOf":[{"type":"string","enum":["higher_is_worse","higher_is_better"]},{"type":"null"}]},"from":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"to":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"values":{"type":"object","propertyNames":{"type":"string","minLength":2,"maxLength":2},"additionalProperties":{"type":"array","items":{"anyOf":[{"type":"number"},{"type":"null"}]}}},"coverage":{"type":"object","properties":{"countries":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"readings":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"firstYearWithData":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lastYearWithData":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["countries","readings","firstYearWithData","lastYearWithData"],"additionalProperties":false},"sourceDocumentIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["layer","metric","name","unit","direction","from","to","values","coverage","sourceDocumentIds"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}]}}}},"404":{"description":"No such annual layer is published.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"The world reader is not configured.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/observatories/{topic}":{"get":{"tags":["Observatories"],"summary":"Migration or housing observatory series","description":"Source-gated statistical projection for PR-010/011. Returns a stable definition, bitemporal observations, an opaque cursor tied to filters and `knownAt`, and explicit coverage. Definitions may be `unavailable` while source mapping or rights approval is pending; unavailable responses never include factual observations.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"topic","in":"path","required":true,"schema":{"type":"string","enum":["migration","housing","labour_market"]}},{"name":"indicator","in":"query","required":false,"schema":{"type":"string","enum":["foreign_born_share","immigration_flow","first_asylum_applicants","irregular_arrivals","house_price_index","rental_monthly_median","housing_cost_overburden","average_wage_gross_annual","minimum_wage_gross_monthly"]}},{"name":"geo","in":"query","required":false,"schema":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","minLength":1}}},{"name":"from","in":"query","required":false,"schema":{"default":2015,"type":"integer","minimum":2015,"maximum":9007199254740991}},{"name":"to","in":"query","required":false,"schema":{"type":"integer","minimum":2015,"maximum":9007199254740991}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":200,"type":"integer","minimum":1,"maximum":1000}}],"responses":{"200":{"description":"The selected observatory definition and observation page.","content":{"application/json":{"schema":{"type":"object","properties":{"definition":{"type":"object","properties":{"key":{"type":"string","enum":["foreign_born_share","immigration_flow","first_asylum_applicants","irregular_arrivals","house_price_index","rental_monthly_median","housing_cost_overburden","average_wage_gross_annual","minimum_wage_gross_monthly"]},"topic":{"type":"string","enum":["migration","housing","labour_market"]},"label":{"type":"string","minLength":1},"definition":{"type":"string","minLength":1},"unit":{"type":"string","enum":["persons","percent","per_1000","index","eur_month","lcu_month","lcu_year"]},"frequency":{"type":"string","enum":["annual","quarterly","cumulative"]},"populationUniverse":{"type":"string","minLength":1},"sourceDatasetRef":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"sourceVariants":{"default":[],"type":"array","items":{"type":"object","properties":{"sourceDatasetRef":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"geoLevels":{"minItems":1,"type":"array","items":{"type":"string","enum":["country","autonomous_community","autonomous_city"]}},"geoCodes":{"anyOf":[{"type":"array","items":{"type":"string","minLength":1}},{"type":"null"}]}},"required":["sourceDatasetRef","geoLevels","geoCodes"],"additionalProperties":false}},"methodologyUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"geoLevels":{"minItems":1,"type":"array","items":{"type":"string","enum":["country","autonomous_community","autonomous_city"]}},"denominatorDefinition":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"basePeriod":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"comparabilityGroup":{"type":"string","minLength":1},"nextReleaseOn":{"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"null"}]},"publicationState":{"type":"string","enum":["published","unavailable"]},"unavailableReason":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"wageBasis":{"anyOf":[{"type":"string","enum":["gross","net"]},{"type":"null"}]},"wagePayPeriod":{"anyOf":[{"type":"string","enum":["hourly","monthly","annual"]},{"type":"null"}]}},"required":["key","topic","label","definition","unit","frequency","populationUniverse","sourceDatasetRef","sourceVariants","methodologyUrl","geoLevels","denominatorDefinition","basePeriod","comparabilityGroup","nextReleaseOn","publicationState","unavailableReason","wageBasis","wagePayPeriod"],"additionalProperties":false},"observations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"indicatorKey":{"type":"string","enum":["foreign_born_share","immigration_flow","first_asylum_applicants","irregular_arrivals","house_price_index","rental_monthly_median","housing_cost_overburden","average_wage_gross_annual","minimum_wage_gross_monthly"]},"geoCode":{"type":"string","minLength":1},"geoLevel":{"type":"string","enum":["country","autonomous_community","autonomous_city"]},"periodStart":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"periodEnd":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"missingReason":{"anyOf":[{"type":"string","enum":["not_ingested","not_available","suppressed","not_comparable","no_statutory_minimum","variable_sub_national_or_sectoral"]},{"type":"null"}]},"status":{"type":"string","enum":["provisional","final"]},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceUrl":{"type":"string","format":"uri"},"sourcePublishedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"recordedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"methodologyVersion":{"type":"string","minLength":1},"unit":{"type":"string","enum":["persons","percent","per_1000","index","eur_month","lcu_month","lcu_year"]},"basePeriod":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"denominatorValue":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"denominatorDocumentId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"coverageNote":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"currency":{"anyOf":[{"type":"string","pattern":"^[A-Z]{3}$"},{"type":"null"}]},"paymentsPerYear":{"anyOf":[{"type":"integer","minimum":1,"maximum":24},{"type":"null"}]}},"required":["id","revisionId","indicatorKey","geoCode","geoLevel","periodStart","periodEnd","value","missingReason","status","sourceDocumentId","sourceUrl","sourcePublishedAt","recordedAt","methodologyVersion","unit","basePeriod","denominatorValue","denominatorDocumentId","coverageNote","currency","paymentsPerYear"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"coverage":{"type":"object","properties":{"state":{"type":"string","enum":["ready","empty","partial","unavailable"]},"expectedGeographies":{"type":"integer","minimum":0,"maximum":9007199254740991},"availableGeographies":{"type":"integer","minimum":0,"maximum":9007199254740991},"observations":{"type":"integer","minimum":0,"maximum":9007199254740991},"unavailableReason":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["state","expectedGeographies","availableGeographies","observations","unavailableReason"],"additionalProperties":false}},"required":["definition","observations","nextCursor","resolvedKnownAt","coverage"],"additionalProperties":false}}}},"400":{"description":"Invalid filters, cursor mismatch, or incompatible indicator/topic.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Unknown observatory topic.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"The persistence adapter or requested definition is not configured.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/world/exposure":{"get":{"tags":["Map & World"],"summary":"Latest geoexposure score per country","description":"Public choropleth layer; `data` is null when no score has ever been calculated.","security":[],"x-rate-limit-class":"public-read","parameters":[],"responses":{"200":{"description":"Exposure scores.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"version":{"type":"string","const":"geoexposure-v1"},"calculatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"values":{"type":"object","propertyNames":{"type":"string","minLength":2,"maxLength":2},"additionalProperties":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]}},"quality":{"type":"object","propertyNames":{"type":"string","minLength":2,"maxLength":2},"additionalProperties":{"type":"string","enum":["complete","partial","stale"]}}},"required":["version","calculatedAt","values","quality"],"additionalProperties":false},{"type":"null"}]}},"required":["data"],"additionalProperties":false}}}}}}},"/v1/world/tension":{"get":{"tags":["Map & World"],"summary":"Calibrated global tension index","description":"Public. The current reading plus annual history; 100 is the documented great-power total-war reference. `data` is null when nothing has been computed yet.","security":[],"x-rate-limit-class":"public-read","parameters":[],"responses":{"200":{"description":"World tension readings.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"version":{"type":"string","const":"world-tension-v1"},"calculatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"current":{"anyOf":[{"type":"object","properties":{"score":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"dimensions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"coverage":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number","minimum":0,"maximum":1}},"reducedTo":{"type":"array","items":{"type":"string"}},"quality":{"type":"string","enum":["complete","partial"]},"asOf":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["score","dimensions","coverage","reducedTo","quality","asOf"],"additionalProperties":false},{"type":"null"}]},"history":{"type":"array","items":{"type":"object","properties":{"score":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"dimensions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"coverage":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number","minimum":0,"maximum":1}},"reducedTo":{"type":"array","items":{"type":"string"}},"quality":{"type":"string","enum":["complete","partial"]},"asOf":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["score","dimensions","coverage","reducedTo","quality","asOf"],"additionalProperties":false}},"thresholds":{"type":"object","properties":{"calm":{"type":"number"},"elevated":{"type":"number"},"high":{"type":"number"},"critical":{"type":"number"}},"required":["calm","elevated","high","critical"],"additionalProperties":false}},"required":["version","calculatedAt","current","history","thresholds"],"additionalProperties":false},{"type":"null"}]}},"required":["data"],"additionalProperties":false}}}}}}},"/v1/world/tension/pairs":{"get":{"tags":["Map & World"],"summary":"Directed bilateral tension reading","description":"Public. `from` is the emitter side of the published relation edges behind the score, `to` the counterpart. `data` is null when no score has been computed for the pair — never a synthetic zero.","security":[],"x-rate-limit-class":"public-read","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z]{2}$"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z]{2}$"}}],"responses":{"200":{"description":"Bilateral tension reading, or null when not computed.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"version":{"type":"string","const":"country-pair-tension-v1"},"fromIso2":{"type":"string","minLength":2,"maxLength":2},"toIso2":{"type":"string","minLength":2,"maxLength":2},"score":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"dimensions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"coverage":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number","minimum":0,"maximum":1}},"reducedTo":{"type":"array","items":{"type":"string"}},"quality":{"type":"string","enum":["complete","partial"]},"calculatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["version","fromIso2","toIso2","score","dimensions","coverage","reducedTo","quality","calculatedAt"],"additionalProperties":false},{"type":"null"}]}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"from and to are not two distinct ISO-2 codes.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"The world reader is not configured.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/world/connections":{"get":{"tags":["Map & World"],"summary":"Relationship edges for one entity","description":"Authenticated. Returns the entity's relationships as connection edges.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"entity","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Entity id to expand connections for."}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"Connection edges.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"fromId":{"type":"string","minLength":1},"toId":{"type":"string","minLength":1},"type":{"type":"string","minLength":1},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"inferred":{"type":"boolean"},"geometry":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"LineString"},"coordinates":{"minItems":2,"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}]}}},"required":["type","coordinates"],"additionalProperties":false},{"type":"null"}]},"evidenceIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["id","fromId","toId","type","confidence","inferred","geometry","evidenceIds"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Entity not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/world/countries/{iso2}":{"get":{"tags":["Map & World"],"summary":"Country brief","description":"Public country projection: gauges, problems, resource trends, optional geometry.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"geometry","in":"query","required":false,"schema":{"description":"Include country boundary geometry when `true`.","type":"string","enum":["true","false"]}},{"name":"asOf","in":"query","required":false,"schema":{"description":"Valid-time instant for the government/tensions blocks (the single world clock).","type":"string"}},{"name":"knownAt","in":"query","required":false,"schema":{"description":"Knowledge-time instant. Accepted since STATE_FORM.md §7; today only the State-based `brief.government` block is scoped by it.","type":"string"}}],"responses":{"200":{"description":"The country brief.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"iso2":{"type":"string","minLength":2,"maxLength":2},"name":{"type":"object","properties":{"es":{"type":"string"},"en":{"type":"string"}},"required":["es","en"],"additionalProperties":false},"geometry":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["Point","MultiPoint","LineString","MultiLineString","Polygon","MultiPolygon"]},"coordinates":{}},"required":["type","coordinates"],"additionalProperties":false},{"type":"null"}]},"resources":{"type":"array","items":{"type":"object","properties":{"resource":{"type":"string","enum":["oil","natural_gas","coal","uranium","wheat","maize","nitrogen_fertilizer","phosphate_fertilizer","potash"]},"metric":{"type":"string","enum":["reserves","production","consumption","imports","exports","dependency","bilateral_flow"]},"valueOriginal":{"type":"number"},"unitOriginal":{"type":"string","minLength":1},"valueNormalized":{"anyOf":[{"type":"number"},{"type":"null"}]},"unitNormalized":{"anyOf":[{"type":"string"},{"type":"null"}]},"conversionVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"periodFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"periodTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"freshness":{"type":"string","enum":["current","stale"]},"trend":{"anyOf":[{"type":"object","properties":{"previousValue":{"type":"number"},"previousYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"changePct":{"anyOf":[{"type":"number"},{"type":"null"}]},"direction":{"type":"string","enum":["up","down","flat"]}},"required":["previousValue","previousYear","changePct","direction"],"additionalProperties":false},{"type":"null"}]}},"required":["resource","metric","valueOriginal","unitOriginal","valueNormalized","unitNormalized","conversionVersion","periodFrom","periodTo","sourceDocumentId","freshness","trend"],"additionalProperties":false}},"exposure":{"anyOf":[{"type":"object","properties":{"version":{"type":"string","const":"geoexposure-v1"},"score":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"dependency":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"situations":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"concentration":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"routes":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"coverage":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number","minimum":0,"maximum":1}},"quality":{"type":"string","enum":["complete","partial","stale"]},"calculatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["version","score","dependency","situations","concentration","routes","coverage","quality","calculatedAt"],"additionalProperties":false},{"type":"null"}]},"brief":{"type":"object","properties":{"gauges":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["conflict","macro_stress","external_dependency"]},"value":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"percentile":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"coverage":{"type":"number","minimum":0,"maximum":1},"quality":{"type":"string","enum":["complete","partial","insufficient"]},"dimensions":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1},"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"percentile":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"peers":{"type":"integer","minimum":0,"maximum":9007199254740991},"inverted":{"type":"boolean"}},"required":["code","value","unit","year","percentile","peers","inverted"],"additionalProperties":false}},"reducedTo":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["code","value","percentile","coverage","quality","dimensions","reducedTo"],"additionalProperties":false}},"problems":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1},"kind":{"type":"string","enum":["conflict","indicator"]},"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"percentile":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"peers":{"type":"integer","minimum":0,"maximum":9007199254740991},"inverted":{"type":"boolean"}},"required":["code","kind","value","unit","year","percentile","peers","inverted"],"additionalProperties":false}},"latestYear":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"government":{"default":null,"anyOf":[{"type":"object","properties":{"headOfState":{"anyOf":[{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalName":{"type":"string"}},"required":["entityId","canonicalName"],"additionalProperties":false},{"type":"null"}]},"headOfGovernment":{"anyOf":[{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalName":{"type":"string"}},"required":["entityId","canonicalName"],"additionalProperties":false},{"type":"null"}]},"since":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"sourceDocumentId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["headOfState","headOfGovernment","since","sourceDocumentId"],"additionalProperties":false},{"type":"null"}]}},"required":["gauges","problems","latestYear","government"],"additionalProperties":false},"government":{"default":null,"anyOf":[{"type":"object","properties":{"headOfState":{"anyOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1},"office":{"type":"string","enum":["head_of_state","head_of_government"]},"officeLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"source":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","title","url"],"additionalProperties":false},{"type":"null"}]}},"required":["name","office","officeLabel","validFrom","validTo","source"],"additionalProperties":false},{"type":"null"}]},"headOfGovernment":{"anyOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1},"office":{"type":"string","enum":["head_of_state","head_of_government"]},"officeLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"source":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","title","url"],"additionalProperties":false},{"type":"null"}]}},"required":["name","office","officeLabel","validFrom","validTo","source"],"additionalProperties":false},{"type":"null"}]}},"required":["headOfState","headOfGovernment"],"additionalProperties":false},{"type":"null"}]},"tensions":{"default":null,"anyOf":[{"type":"array","items":{"type":"object","properties":{"predicate":{"type":"string","minLength":1},"counterpart":{"type":"object","properties":{"iso2":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1}},"required":["iso2","name"],"additionalProperties":false},"locus":{"anyOf":[{"type":"string"},{"type":"null"}]},"emitter":{"anyOf":[{"type":"string"},{"type":"null"}]},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"source":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","title","url"],"additionalProperties":false},{"type":"null"}]}},"required":["predicate","counterpart","locus","emitter","validFrom","validTo","source"],"additionalProperties":false}},{"type":"null"}]},"relations":{"default":null,"anyOf":[{"type":"array","items":{"type":"object","properties":{"predicate":{"type":"string","enum":["member_of","party_to","sanctions","operates","owns","produces","consumes","stores","transports","provides_service","supports_service","service_area","administers","claims","observed_control","diplomacy.member_of","diplomacy.alliance_with","military.supports","diplomacy.border_incident_with","sanctions.designated_by"]},"direction":{"type":"string","enum":["outgoing","incoming"]},"from":{"type":"object","properties":{"kind":{"type":"string","enum":["country","organization"]},"iso2":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1}},"required":["kind","iso2","id","name"],"additionalProperties":false},"to":{"type":"object","properties":{"kind":{"type":"string","enum":["country","organization"]},"iso2":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1}},"required":["kind","iso2","id","name"],"additionalProperties":false},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"evidence":{"anyOf":[{"type":"object","properties":{"sourceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quote":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["sourceName","sourceTitle","sourceUrl","publishedAt","locator","quote"],"additionalProperties":false},{"type":"null"}]}},"required":["predicate","direction","from","to","validFrom","validTo","evidence"],"additionalProperties":false}},{"type":"null"}]},"pairTensions":{"default":null,"anyOf":[{"type":"array","items":{"type":"object","properties":{"fromIso2":{"type":"string","minLength":2,"maxLength":2},"toIso2":{"type":"string","minLength":2,"maxLength":2},"counterpartIso2":{"type":"string","minLength":2,"maxLength":2},"score":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"quality":{"type":"string","enum":["complete","partial"]},"reducedTo":{"type":"array","items":{"type":"string"}}},"required":["fromIso2","toIso2","counterpartIso2","score","quality","reducedTo"],"additionalProperties":false}},{"type":"null"}]}},"required":["iso2","name","geometry","resources","exposure","brief","government","tensions","relations","pairTensions"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"503":{"description":"The world reader is not configured.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/world/situations/{slug}":{"get":{"tags":["Map & World"],"summary":"Situation projection","description":"Public situation (armed conflict, sanctions regime, ...) projection. Some fields (or the whole record, for pilot situations awaiting backfill) require authentication.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[],"responses":{"200":{"description":"The situation.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string","minLength":1},"type":{"type":"string","enum":["armed_conflict","geopolitical_confrontation","crisis","sanctions_regime"]},"name":{"type":"object","properties":{"es":{"type":"string"},"en":{"type":"string"}},"required":["es","en"],"additionalProperties":false},"summary":{"type":"object","properties":{"es":{"type":"string"},"en":{"type":"string"}},"required":["es","en"],"additionalProperties":false},"status":{"type":"string","enum":["active","inactive","resolved"]},"severity":{"type":"string","enum":["low","medium","high","critical"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"verificationStatus":{"type":"string","enum":["provisional","verified"]},"verificationMethod":{"type":"string","enum":["human","automated","hybrid"]},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"geometry":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["Point","MultiPoint","LineString","MultiLineString","Polygon","MultiPolygon"]},"coordinates":{}},"required":["type","coordinates"],"additionalProperties":false},{"type":"null"}]},"participants":{"type":"array","items":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"role":{"type":"string"}},"required":["entityId","role"],"additionalProperties":false}},"eventIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"evidenceIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"fatalities":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"source":{"default":null,"anyOf":[{"type":"object","properties":{"provider":{"type":"string","minLength":1},"dataset":{"type":"string","minLength":1},"version":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"license":{"anyOf":[{"type":"string"},{"type":"null"}]},"attribution":{"anyOf":[{"type":"string"},{"type":"null"}]},"termsUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["provider","dataset","version","title","url","license","attribution","termsUrl","publishedAt","retrievedAt"],"additionalProperties":false},{"type":"null"}]}},"required":["id","slug","type","name","summary","status","severity","confidence","verificationStatus","verificationMethod","validFrom","validTo","geometry","participants","eventIds","evidenceIds","fatalities","source"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Situation not found (or requires authentication).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/world/export":{"get":{"tags":["Map & World"],"summary":"Export a country's events","description":"Authenticated. `scope=country&id=ISO2`, as JSON or CSV.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"scope","in":"query","required":true,"schema":{"type":"string","const":"country","description":"Only `country` is supported today."}},{"name":"id","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country code."}},{"name":"format","in":"query","required":false,"schema":{"default":"json","type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Events for the country, as JSON or a CSV attachment.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"source":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"language":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","title","url","publishedAt"],"additionalProperties":false},{"type":"null"}]},"excerpt":{"anyOf":[{"type":"string","maxLength":280},{"type":"null"}]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]},"family":{"default":"economic","type":"string","enum":["conflict","economic","political","infrastructure"]},"typeCode":{"default":"sanction","type":"string","maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},"status":{"type":"string","const":"published"},"severity":{"type":"string","enum":["low","medium","high","critical"]},"title":{"type":"string"},"summary":{"type":"string"},"occurrence":{"type":"object","properties":{"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["from","to"],"additionalProperties":false},"locations":{"type":"array","items":{"type":"object","properties":{"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"name":{"type":"string","minLength":1},"latitude":{"anyOf":[{"type":"number","minimum":-90,"maximum":90},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number","minimum":-180,"maximum":180},{"type":"null"}]}},"required":["countryCode","name","latitude","longitude"],"additionalProperties":false}},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"verificationStatus":{"default":"verified","type":"string","enum":["provisional","verified"]},"verificationMethod":{"default":"human","type":"string","enum":["human","automated","hybrid"]},"qualityStatus":{"default":"clear","type":"string","enum":["clear","warning","disputed"]},"entities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["country","region","company","sector","industry","commodity","resource","infrastructure","trade_route","regulation","government","organization","person","political_party","service"]},"canonicalName":{"type":"string"}},"required":["id","kind","canonicalName"],"additionalProperties":false}},"claims":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact","observed_outcome"]},"statement":{"type":"string"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}}},"required":["id","kind","statement","confidence","evidence"],"additionalProperties":false}},"relationships":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"fromEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"toEntityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"strength":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","fromEntityId","toEntityId","type","direction","strength","confidence","evidence","validFrom","validTo"],"additionalProperties":false}},"impacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"entityId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claimId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"direction":{"type":"string","enum":["positive","negative","mixed","neutral","unknown"]},"mechanism":{"type":"string"},"horizon":{"type":"string","enum":["immediate","short_term","medium_term","long_term"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"outcomeClaimId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceDocumentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"locator":{"anyOf":[{"type":"string"},{"type":"null"}]},"quotedSpan":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","sourceDocumentId","sourceName","sourceUrl","language","locator","quotedSpan","publishedAt","retrievedAt"],"additionalProperties":false}},"reviewStatus":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]}},"required":["id","entityId","claimId","direction","mechanism","horizon","confidence","outcomeClaimId","evidence"],"additionalProperties":false}},"claimCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"entityCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"evidenceCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","type","family","typeCode","status","severity","title","summary","occurrence","locations","confidence","verificationStatus","verificationMethod","qualityStatus","entities","claims","relationships","impacts","updatedAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}}}}},"/v1/world/layers":{"get":{"tags":["Map & World"],"summary":"World layer catalogue","description":"DAT-02 layer definitions and catalogue snapshot.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[],"responses":{"200":{"description":"Layer catalogue envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/viewport":{"get":{"tags":["Map & World"],"summary":"Viewport features and clusters","description":"NET-02 viewport query with layerStates and pagination.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"bbox","in":"query","required":true,"schema":{"type":"string","pattern":"^-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?$"}},{"name":"zoom","in":"query","required":false,"schema":{"default":2,"type":"number","minimum":0,"maximum":16}},{"name":"layers","in":"query","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"type":"string","maxLength":2048}},{"name":"snapshotId","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":500,"type":"integer","minimum":1,"maximum":2000}},{"name":"locale","in":"query","required":false,"schema":{"default":"en","type":"string","enum":["es","en"]}}],"responses":{"200":{"description":"Viewport envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}},"409":{"description":"Cursor belongs to another query.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/world/search":{"get":{"tags":["Map & World"],"summary":"Search published world objects","description":"Full-text search over published geographies, assets, and entities.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"kinds","in":"query","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2}}],"responses":{"200":{"description":"Search results envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/changes":{"get":{"tags":["Map & World"],"summary":"World change feed","description":"Grouped world changes by decision within a bounded time window.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"changeClock","in":"query","required":false,"schema":{"default":"known","type":"string","enum":["valid","known"]}},{"name":"changeFrom","in":"query","required":true,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"changeTo","in":"query","required":true,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"scope","in":"query","required":false,"schema":{"default":"viewport","type":"string","enum":["selection","viewport","global"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Grouped world changes.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/clusters/{key}/members":{"get":{"tags":["Map & World"],"summary":"Paginated cluster members","description":"Expand a viewport cluster key into its authorized member features.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[],"responses":{"200":{"description":"Cluster members envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/geographies/{id}":{"get":{"tags":["Map & World"],"summary":"Geography unit detail","description":"Geography unit with ancestors, paginated children, and geometry version.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"Geography envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/observations":{"get":{"tags":["Map & World"],"summary":"Metric observations projection","description":"DAT-03 observations projected from statistical and object sources.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"metric","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"geoIds","in":"query","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":1000,"type":"integer","minimum":1,"maximum":1000}}],"responses":{"200":{"description":"Observations envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/objects/{kind}/{id}":{"get":{"tags":["Map & World"],"summary":"World object detail","description":"Detail for event, asset, connection, or entity world objects.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"Object envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/objects/{kind}/{id}/observations":{"get":{"tags":["Map & World"],"summary":"Observations for a world object","description":"Metric observations attached to a specific world object.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[],"responses":{"200":{"description":"Object observations envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/objects/{kind}/{id}/explanations":{"get":{"tags":["Map & World"],"summary":"Public impact explanations","description":"Paginated public impact explanation summaries for a world object.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"Explanation page.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"impactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"impactVersionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["current","needs_review","withdrawn","legacy_untracked"]},"method":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z][a-z0-9_]*$"},"version":{"type":"string","minLength":1,"maxLength":40}},"required":["code","version"],"additionalProperties":false},{"type":"null"}]},"explanation":{"anyOf":[{"type":"string"},{"type":"null"}]},"premises":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["claim","relationship","entity"]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"role":{"type":"string","enum":["triggering_fact","exposure_link","identity"]},"projection":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["type","id","versionId","role","projection"],"additionalProperties":false}},"completeness":{"type":"string","enum":["complete","restricted","legacy"]}},"required":["impactId","impactVersionId","status","method","explanation","premises","completeness"],"additionalProperties":false},"meta":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"knownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["asOf","knownAt"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/v1/world/relations":{"get":{"tags":["Map & World"],"summary":"Entity relation graph page","description":"Actor relations and connected nodes up to depth 2.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"Relations envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/actors/{id}":{"get":{"tags":["Map & World"],"summary":"Actor detail","description":"Published actor projection with typed relations.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"Actor envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/territorial-assertions":{"get":{"tags":["Map & World"],"summary":"Territorial assertions list","description":"Published territorial assertions with temporal filters.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"Assertions envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/paths":{"get":{"tags":["Map & World"],"summary":"Network path search","description":"Bounded multi-hop path search over published network edges.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"mode","in":"query","required":false,"schema":{"type":"string"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"snapshotId","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Path results envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/metrics":{"get":{"tags":["Map & World"],"summary":"Metric definitions catalogue","description":"Published world metric definitions and comparability metadata.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[],"responses":{"200":{"description":"Metrics envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/raster-sample":{"get":{"tags":["Map & World"],"summary":"Nearest-cell raster sample","description":"Nearest-cell raster value for a layer revision and period.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"layer","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"revision","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"period","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"Raster sample envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/world/intersections":{"get":{"tags":["Map & World"],"summary":"Spatial intersections","description":"Spatial coincidence query with explicit non-causation disclaimer.","security":[{"bearerAuth":[]},{}],"x-rate-limit-class":"public-read","parameters":[{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"knownAt","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}],"responses":{"200":{"description":"Intersections envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resolvedAsOf":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"resolvedKnownAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"queryKey":{"type":"string","minLength":1},"layerStates":{"type":"array","items":{"type":"object","properties":{"layerId":{"type":"string","enum":["territory_jurisdiction","territory_claims","territory_control","conflict_frontlines","assets","connections","pipelines","physical_relief","air_temperature_2m","situations","events","geoexposure"]},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["ready","empty","partial","unavailable","error"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"expectedUnits":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"availableUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"rejectedUnits":{"type":"integer","minimum":0,"maximum":9007199254740991},"unlocatedRecords":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUnits","availableUnits","rejectedUnits","unlocatedRecords"],"additionalProperties":false},"renderedLevel":{"type":"integer","minimum":0,"maximum":9007199254740991},"sourcePeriod":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["start","end"],"additionalProperties":false},{"type":"null"}]}},"required":["layerId","revisionId","status","reason","coverage","renderedLevel","sourcePeriod"],"additionalProperties":false}},"counts":{"type":"object","properties":{"events":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"territories":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["events","assets","territories"],"additionalProperties":false},"countScope":{"type":"string","enum":["exact","lower_bound","unknown"]},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"truncated":{"type":"boolean"}},"required":["data","snapshotId","resolvedAsOf","resolvedKnownAt","generatedAt","queryKey","layerStates","counts","countScope","nextCursor","truncated"],"additionalProperties":false}}}}}}},"/v1/editorial/world/territorial-assertions":{"post":{"tags":["Editorial"],"summary":"Stage territorial assertion","description":"Editorial staging for territorial assertions; does not auto-publish.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[],"responses":{"201":{"description":"Staging request accepted.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string"}},"required":["requestId","status"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}}}},"/v1/editorial/world/metric-observations":{"post":{"tags":["Editorial"],"summary":"Stage metric observation","description":"Editorial staging for metric observations; does not auto-publish.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[],"responses":{"201":{"description":"Staging request accepted.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string"}},"required":["requestId","status"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}}}},"/v1/me":{"get":{"tags":["Account"],"summary":"Current user profile","description":"Authenticated. Profile preferences plus resolved workspace roles.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[],"responses":{"200":{"description":"The profile.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"userId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceRoles":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["viewer","analyst","reviewer","admin"]}}},"required":["userId","workspaceRoles"],"additionalProperties":{},"description":"Profile preferences are stored free-form and returned alongside the identity fields."}},"required":["data"],"additionalProperties":false}}}}}}},"/v1/reviews":{"get":{"tags":["Editorial"],"summary":"List the editorial review queue","description":"Authenticated, reviewer/admin of the requested workspace.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"A page of pending reviews.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"pipelineCommitId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"processedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"diagnostics":{"type":"array","items":{"type":"string"}},"source":{"type":"object","properties":{"sourceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"externalId":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["sourceId","sourceName","documentId","externalId","title","url","publishedAt","retrievedAt"],"additionalProperties":false},"event":{"type":"object","properties":{"type":{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]},"severity":{"type":"string","enum":["low","medium","high","critical"]},"title":{"type":"string","minLength":1},"summary":{"type":"string","minLength":1},"occurredFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]}},"required":["type","severity","title","summary","occurredFrom","confidence"],"additionalProperties":false},"evaluationSummary":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["total","failed"],"additionalProperties":false},"ambiguousResolutionCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"qualityFlags":{"type":"array","items":{"type":"string","enum":["missing_confidence","low_confidence","failed_evaluations","ambiguous_resolution","diagnostics_present","unverified_evidence"]}}},"required":["pipelineCommitId","eventId","workspaceId","processedAt","diagnostics","source","event","evaluationSummary","ambiguousResolutionCount","qualityFlags"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}},"403":{"description":"Reviewer role required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/ingestions":{"get":{"tags":["Editorial"],"summary":"List ingestion runs","description":"Authenticated, reviewer/admin of the requested workspace.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["registered","pending_review","published","rejected","changes_requested"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"A page of ingestion runs.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"pipelineCommitId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"runId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"processedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"status":{"type":"string","enum":["registered","pending_review","published","rejected","changes_requested"]},"source":{"type":"object","properties":{"sourceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceName":{"type":"string","minLength":1},"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"externalId":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["sourceId","sourceName","documentId","externalId","title","url","publishedAt","retrievedAt"],"additionalProperties":false},"event":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["export_restriction","sanction","trade_restriction","armed_clash","military_attack","ceasefire","diplomatic_action","cyber_operation","supply_disruption","infrastructure_disruption","regulatory_change"]},"severity":{"type":"string","enum":["low","medium","high","critical"]},"title":{"type":"string","minLength":1},"summary":{"type":"string","minLength":1},"occurredFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]}},"required":["id","type","severity","title","summary","occurredFrom","confidence"],"additionalProperties":false},{"type":"null"}]},"diagnostics":{"type":"array","items":{"type":"string"}},"evaluationSummary":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["total","failed"],"additionalProperties":false},"ambiguousResolutionCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"qualityFlags":{"type":"array","items":{"type":"string","enum":["missing_confidence","low_confidence","failed_evaluations","ambiguous_resolution","diagnostics_present","unverified_evidence"]}},"review":{"anyOf":[{"type":"object","properties":{"decision":{"type":"string","enum":["reject","request_changes","publish"]},"reason":{"type":"string","minLength":1},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["decision","reason","createdAt"],"additionalProperties":false},{"type":"null"}]}},"required":["pipelineCommitId","runId","workspaceId","processedAt","status","source","event","diagnostics","evaluationSummary","ambiguousResolutionCount","qualityFlags","review"],"additionalProperties":false}},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}},"403":{"description":"Reviewer role required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/admin/load-diary":{"get":{"tags":["Admin"],"summary":"Load diary by day and form","description":"Admin-only operational read (docs/product/ADMIN.md §3): daily flows of the freeze → assess → load → publish → retract cycle over the public-projection corpus, plus the current public corpus counts. Days are Europe/Madrid calendar days.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"form","in":"query","required":false,"schema":{"type":"string","enum":["Event","Observation","Identity","Geometry","Edge"]}}],"responses":{"200":{"description":"Diary rows and corpus anchor.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"form":{"anyOf":[{"type":"string","enum":["Event","Observation","Identity","Geometry","Edge","unknown"]},{"type":"null"}]},"frozen":{"type":"integer","minimum":0,"maximum":9007199254740991},"assessed":{"type":"integer","minimum":0,"maximum":9007199254740991},"candidates":{"type":"integer","minimum":0,"maximum":9007199254740991},"candidatesPending":{"type":"integer","minimum":0,"maximum":9007199254740991},"published":{"type":"integer","minimum":0,"maximum":9007199254740991},"publishedIdentities":{"type":"integer","minimum":0,"maximum":9007199254740991},"retracted":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["day","form","frozen","assessed","candidates","candidatesPending","published","publishedIdentities","retracted"],"additionalProperties":false}},"corpus":{"type":"object","properties":{"publicEvents":{"type":"integer","minimum":0,"maximum":9007199254740991},"publicEntities":{"type":"integer","minimum":0,"maximum":9007199254740991},"publicClaims":{"type":"integer","minimum":0,"maximum":9007199254740991},"publicRelationships":{"type":"integer","minimum":0,"maximum":9007199254740991},"publicImpacts":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["publicEvents","publicEntities","publicClaims","publicRelationships","publicImpacts"],"additionalProperties":false},"range":{"type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["from","to"],"additionalProperties":false}},"required":["data","corpus","range"],"additionalProperties":false}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/admin/invisibility":{"get":{"tags":["Admin"],"summary":"Invisibility panel rows","description":"Admin-only operational read (docs/product/ADMIN.md §4): current graph versions that fail their `publication_boundary_*` predicate at `now()`, each with the first failing gate from the closed `InvisibilityReason` enum.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"objectKind","in":"query","required":false,"schema":{"type":"string","enum":["event","claim","impact","relationship","entity"]}},{"name":"reason","in":"query","required":false,"schema":{"type":"string","enum":["workspace_bound","visibility_not_public","status_not_published","outside_valid_interval","outside_recorded_interval","no_claims","claim_fails","empty_evidence","missing_assessment","assessment_not_approved","missing_event_evidence_scope","supports_claim_false","excerpt_not_verified","model_processing_forbidden","assessment_expired","evidence_rights_not_approved","document_workspace_bound","insufficient_roots","discovery_excluded","constitutive_unscoped","constitutive_role_mismatch","constitutive_dataset_forbids","constitutive_authority_insufficient","constitutive_actor_not_modelled","event_projection_fails","claim_not_public","nested_claim_or_event_fails","entity_without_published_edge_or_impact"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"A page of invisible rows, corpus anchor and orphan count.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"objectKind":{"type":"string","enum":["event","claim","impact","relationship","entity"]},"objectId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"title":{"type":"string"},"reason":{"type":"string","enum":["workspace_bound","visibility_not_public","status_not_published","outside_valid_interval","outside_recorded_interval","no_claims","claim_fails","empty_evidence","missing_assessment","assessment_not_approved","missing_event_evidence_scope","supports_claim_false","excerpt_not_verified","model_processing_forbidden","assessment_expired","evidence_rights_not_approved","document_workspace_bound","insufficient_roots","discovery_excluded","constitutive_unscoped","constitutive_role_mismatch","constitutive_dataset_forbids","constitutive_authority_insufficient","constitutive_actor_not_modelled","event_projection_fails","claim_not_public","nested_claim_or_event_fails","entity_without_published_edge_or_impact"]},"causedBy":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"editorialRoots":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"asOf":{"type":"string"},"knownAt":{"type":"string"}},"required":["objectKind","objectId","versionId","title","reason","causedBy","editorialRoots","expiresAt","asOf","knownAt"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"corpus":{"type":"object","properties":{"publicEvents":{"type":"integer","minimum":0,"maximum":9007199254740991},"publicEntities":{"type":"integer","minimum":0,"maximum":9007199254740991},"publicClaims":{"type":"integer","minimum":0,"maximum":9007199254740991},"publicRelationships":{"type":"integer","minimum":0,"maximum":9007199254740991},"publicImpacts":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["publicEvents","publicEntities","publicClaims","publicRelationships","publicImpacts"],"additionalProperties":false},"orphans":{"type":"object","properties":{"eventsWithoutVersions":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["eventsWithoutVersions"],"additionalProperties":false},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","total","corpus","orphans","page"],"additionalProperties":false}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/source-catalog":{"get":{"tags":["Editorial"],"summary":"List the operational source catalogue","description":"Authenticated. Dataset-scoped rights and document assessments for one workspace.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["approved","restricted","discovery_only","pending_legal","rejected","expired"]}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","enum":["discovery","event_evidence","metric","geometry","entity_resolution","export"]}},{"name":"query","in":"query","required":false,"schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"The catalogue.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"name":{"type":"string","minLength":1,"maxLength":300},"authority":{"type":"string","enum":["primary_official","intergovernmental","academic","curated_open","commercial","media","unknown"]},"canonicalDomains":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"homepageUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"contactUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"recurring":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","slug","name","authority","canonicalDomains","homepageUrl","contactUrl","recurring","createdAt","updatedAt"],"additionalProperties":false},"dataset":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"providerId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"name":{"type":"string","minLength":1,"maxLength":500},"version":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"acquisitionMethod":{"type":"string","enum":["api","bulk","feed","web","document"]},"endpointUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"geography":{"default":[],"type":"array","items":{"type":"string"}},"languages":{"default":[],"type":"array","items":{"type":"string"}},"updateCadence":{"anyOf":[{"type":"string"},{"type":"null"}]},"methodologyUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"mappings":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"producibleEvidentiaryRoles":{"default":["declarative","corroborating","discovery"],"type":"array","items":{"type":"string","enum":["constitutive","declarative","corroborating","discovery"]}}},"required":["id","providerId","slug","name","version","acquisitionMethod","endpointUrl","geography","languages","updateCadence","methodologyUrl","mappings","createdAt","updatedAt","producibleEvidentiaryRoles"],"additionalProperties":false},"approval":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"datasetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["approved","restricted","discovery_only","pending_legal","rejected","expired"]},"scopes":{"type":"array","items":{"type":"string","enum":["discovery","event_evidence","metric","geometry","entity_resolution","export"]}},"license":{"anyOf":[{"type":"string"},{"type":"null"}]},"termsUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"termsHash":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}]},"attributionTemplate":{"anyOf":[{"type":"string"},{"type":"null"}]},"commercialUseAllowed":{"type":"boolean"},"rawRedistributionAllowed":{"type":"boolean"},"derivedOutputAllowed":{"type":"boolean"},"fullTextRetentionAllowed":{"type":"boolean"},"excerptRetentionAllowed":{"type":"boolean"},"modelProcessingAllowed":{"type":"boolean"},"thirdPartyCaveats":{"anyOf":[{"type":"string"},{"type":"null"}]},"technicalReviewerId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"legalReviewerId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"reviewKind":{"type":"string","enum":["technical","legal"]},"reason":{"type":"string","minLength":1},"fallbackDatasetId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"recordedFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"recordedTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"reviewedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","datasetId","status","scopes","license","termsUrl","termsHash","attributionTemplate","commercialUseAllowed","rawRedistributionAllowed","derivedOutputAllowed","fullTextRetentionAllowed","excerptRetentionAllowed","modelProcessingAllowed","thirdPartyCaveats","technicalReviewerId","legalReviewerId","reviewKind","reason","fallbackDatasetId","validFrom","validTo","recordedFrom","recordedTo","reviewedAt","expiresAt"],"additionalProperties":false},{"type":"null"}]}},"required":["provider","dataset","approval"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}}}}},"/v1/source-catalog/approvals":{"post":{"tags":["Editorial"],"summary":"Approve or reject a source for a workspace","description":"Authenticated mutation over the source catalogue.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[{"name":"workspaceId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datasetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["approved","restricted","discovery_only","pending_legal","rejected","expired"]},"scopes":{"type":"array","items":{"type":"string","enum":["discovery","event_evidence","metric","geometry","entity_resolution","export"]}},"license":{"anyOf":[{"type":"string"},{"type":"null"}]},"termsUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"termsHash":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}]},"attributionTemplate":{"anyOf":[{"type":"string"},{"type":"null"}]},"commercialUseAllowed":{"type":"boolean"},"rawRedistributionAllowed":{"type":"boolean"},"derivedOutputAllowed":{"type":"boolean"},"fullTextRetentionAllowed":{"type":"boolean"},"excerptRetentionAllowed":{"type":"boolean"},"modelProcessingAllowed":{"type":"boolean"},"thirdPartyCaveats":{"anyOf":[{"type":"string"},{"type":"null"}]},"reviewKind":{"type":"string","enum":["technical","legal"]},"reason":{"type":"string","minLength":1,"maxLength":2000},"fallbackDatasetId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["datasetId","status","scopes","license","termsUrl","termsHash","attributionTemplate","commercialUseAllowed","rawRedistributionAllowed","derivedOutputAllowed","fullTextRetentionAllowed","excerptRetentionAllowed","modelProcessingAllowed","thirdPartyCaveats","reviewKind","reason","fallbackDatasetId"]}}}},"responses":{"201":{"description":"The approval record.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"datasetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["approved","restricted","discovery_only","pending_legal","rejected","expired"]},"scopes":{"type":"array","items":{"type":"string","enum":["discovery","event_evidence","metric","geometry","entity_resolution","export"]}},"license":{"anyOf":[{"type":"string"},{"type":"null"}]},"termsUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"termsHash":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}]},"attributionTemplate":{"anyOf":[{"type":"string"},{"type":"null"}]},"commercialUseAllowed":{"type":"boolean"},"rawRedistributionAllowed":{"type":"boolean"},"derivedOutputAllowed":{"type":"boolean"},"fullTextRetentionAllowed":{"type":"boolean"},"excerptRetentionAllowed":{"type":"boolean"},"modelProcessingAllowed":{"type":"boolean"},"thirdPartyCaveats":{"anyOf":[{"type":"string"},{"type":"null"}]},"technicalReviewerId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"legalReviewerId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"reviewKind":{"type":"string","enum":["technical","legal"]},"reason":{"type":"string","minLength":1},"fallbackDatasetId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"validFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"validTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"recordedFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"recordedTo":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"reviewedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","datasetId","status","scopes","license","termsUrl","termsHash","attributionTemplate","commercialUseAllowed","rawRedistributionAllowed","derivedOutputAllowed","fullTextRetentionAllowed","excerptRetentionAllowed","modelProcessingAllowed","thirdPartyCaveats","technicalReviewerId","legalReviewerId","reviewKind","reason","fallbackDatasetId","validFrom","validTo","recordedFrom","recordedTo","reviewedAt","expiresAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}}}},"/v1/events/{id}/reviews":{"post":{"tags":["Editorial"],"summary":"Record a review decision","description":"Authenticated. Publish, reject, or request changes for a pending event analysis. Publishing with known quality flags requires `confirmQualityRisks: true`.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"editorial-write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"decision":{"type":"string","enum":["reject","request_changes","publish"]},"reason":{"type":"string","minLength":1,"maxLength":2000},"labels":{"default":[],"maxItems":200,"type":"array","items":{"type":"object","properties":{"targetType":{"type":"string","enum":["event","entity","claim","relationship","impact"]},"targetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"label":{"type":"string","enum":["correct","incorrect","ambiguous","missing_evidence"]},"note":{"type":"string","minLength":1,"maxLength":1000}},"required":["targetType","targetId","label"]}},"confirmQualityRisks":{"type":"boolean"}},"required":["workspaceId","decision","reason"]}}}},"responses":{"201":{"description":"The review decision.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["id","eventId"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"No pending event analysis found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Publishing quality risks requires explicit confirmation.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces":{"get":{"tags":["Client panel"],"summary":"List accessible client workspaces","description":"Only enabled client workspaces the caller currently belongs to, with the effective client capability. No editorial-role inheritance.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[],"responses":{"200":{"description":"Accessible client workspaces.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"capability":{"type":"string","enum":["reader","collaborator","profile_manager"]},"plan":{"type":"string","const":"p2"},"perimeterTier":{"type":"number"}},"required":["id","name","capability","plan","perimeterTier"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/profile":{"get":{"tags":["Client panel"],"summary":"Read the shared company profile","description":"Current declared profile version plus operator-held identity resolution state. Absent data means unknown, never zero exposure.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}}],"responses":{"200":{"description":"The profile and its resolution state.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"profile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"version":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"value":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"legalName":{"default":"","type":"string","maxLength":200},"website":{"default":"","anyOf":[{"type":"string","const":""},{"type":"string","format":"uri"}]},"incorporationCountry":{"default":null,"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}]},"externalId":{"default":"","type":"string","maxLength":200},"externalIdScheme":{"default":"","type":"string","maxLength":200},"sector":{"default":"","type":"string","maxLength":200},"sectorEntityId":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"subsectors":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","maxLength":200}},"products":{"default":"","type":"string","maxLength":1000},"description":{"default":"","type":"string","maxLength":2000},"countries":{"default":[],"maxItems":150,"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z]{2}$"},"role":{"type":"string","enum":["operations","purchase","sales"]}},"required":["code","role"],"additionalProperties":false}},"interests":{"default":[],"maxItems":8,"type":"array","items":{"type":"string","enum":["sanctions","regulation","logistics","energy","conflict","reputation","competition","opportunities"]}},"dependenciesUnknown":{"default":true,"type":"boolean"},"draft":{"default":true,"type":"boolean"}},"required":["name","legalName","website","incorporationCountry","externalId","externalIdScheme","sector","sectorEntityId","subsectors","products","description","countries","interests","dependenciesUnknown","draft"],"additionalProperties":false},"recordedFrom":{"type":"string"},"author":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"declaredBy":{"type":"string","const":"client"}},"required":["id","version","value","recordedFrom","author","declaredBy"],"additionalProperties":false},{"type":"null"}]},"identity":{"type":"object","properties":{"entityId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"status":{"type":"string","enum":["pending","resolved"]},"version":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["entityId","status","version"],"additionalProperties":false},"sectorStatus":{"type":"string","enum":["pending_classification","resolved"]}},"required":["profile","identity","sectorStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}},"put":{"tags":["Client panel"],"summary":"Declare a new profile version","description":"Requires the profile-manager capability. Close-and-insert with `expectedVersion` optimistic concurrency; identity resolution stays operator-only.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"value":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"legalName":{"default":"","type":"string","maxLength":200},"website":{"default":"","anyOf":[{"type":"string","const":""},{"type":"string","format":"uri"}]},"incorporationCountry":{"default":null,"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}]},"externalId":{"default":"","type":"string","maxLength":200},"externalIdScheme":{"default":"","type":"string","maxLength":200},"sector":{"default":"","type":"string","maxLength":200},"sectorEntityId":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"subsectors":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","maxLength":200}},"products":{"default":"","type":"string","maxLength":1000},"description":{"default":"","type":"string","maxLength":2000},"countries":{"default":[],"maxItems":150,"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z]{2}$"},"role":{"type":"string","enum":["operations","purchase","sales"]}},"required":["code","role"]}},"interests":{"default":[],"maxItems":8,"type":"array","items":{"type":"string","enum":["sanctions","regulation","logistics","energy","conflict","reputation","competition","opportunities"]}},"dependenciesUnknown":{"default":true,"type":"boolean"},"draft":{"default":true,"type":"boolean"}},"required":["name"],"additionalProperties":false}},"required":["expectedVersion","value"],"additionalProperties":false}}}},"responses":{"200":{"description":"The persisted profile state.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"profile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"version":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"value":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"legalName":{"default":"","type":"string","maxLength":200},"website":{"default":"","anyOf":[{"type":"string","const":""},{"type":"string","format":"uri"}]},"incorporationCountry":{"default":null,"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}]},"externalId":{"default":"","type":"string","maxLength":200},"externalIdScheme":{"default":"","type":"string","maxLength":200},"sector":{"default":"","type":"string","maxLength":200},"sectorEntityId":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"subsectors":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","maxLength":200}},"products":{"default":"","type":"string","maxLength":1000},"description":{"default":"","type":"string","maxLength":2000},"countries":{"default":[],"maxItems":150,"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z]{2}$"},"role":{"type":"string","enum":["operations","purchase","sales"]}},"required":["code","role"],"additionalProperties":false}},"interests":{"default":[],"maxItems":8,"type":"array","items":{"type":"string","enum":["sanctions","regulation","logistics","energy","conflict","reputation","competition","opportunities"]}},"dependenciesUnknown":{"default":true,"type":"boolean"},"draft":{"default":true,"type":"boolean"}},"required":["name","legalName","website","incorporationCountry","externalId","externalIdScheme","sector","sectorEntityId","subsectors","products","description","countries","interests","dependenciesUnknown","draft"],"additionalProperties":false},"recordedFrom":{"type":"string"},"author":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"declaredBy":{"type":"string","const":"client"}},"required":["id","version","value","recordedFrom","author","declaredBy"],"additionalProperties":false},{"type":"null"}]},"identity":{"type":"object","properties":{"entityId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"status":{"type":"string","enum":["pending","resolved"]},"version":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["entityId","status","version"],"additionalProperties":false},"sectorStatus":{"type":"string","enum":["pending_classification","resolved"]}},"required":["profile","identity","sectorStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"The expected version is stale; reload before saving.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/dependencies":{"get":{"tags":["Client panel"],"summary":"List declared dependencies","description":"Current versions of the private dependency context declared by the organization.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}}],"responses":{"200":{"description":"Declared dependencies.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"version":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"value":{"type":"object","properties":{"subject":{"type":"string","enum":["profile","activity","perimeter"]},"perimeterItemId":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"activity":{"default":"","type":"string","maxLength":200},"criticality":{"default":"unknown","type":"string","enum":["high","medium","unknown","low"]},"concentration":{"default":null,"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"concentrationBase":{"default":null,"anyOf":[{"type":"string","enum":["purchase","sales","supply"]},{"type":"null"}]},"substitutability":{"default":"unknown","type":"string","enum":["easy","difficult","none_known","unknown"]},"soleSupplier":{"default":"unknown","type":"string","enum":["yes","no","unknown"]},"inventoryDays":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":36500},{"type":"null"}]},"inventoryDeclaredOn":{"default":null,"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"null"}]},"replacementDays":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":36500},{"type":"null"}]},"sensitivities":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","enum":["energy","materials","currency","regulation","transport"]}},"infrastructure":{"default":"","type":"string","maxLength":500},"notes":{"default":"","type":"string","maxLength":2000}},"required":["subject","perimeterItemId","activity","criticality","concentration","concentrationBase","substitutability","soleSupplier","inventoryDays","inventoryDeclaredOn","replacementDays","sensitivities","infrastructure","notes"],"additionalProperties":false},"recordedFrom":{"type":"string"},"author":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"declaredBy":{"type":"string","const":"client"}},"required":["id","version","value","recordedFrom","author","declaredBy"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}},"post":{"tags":["Client panel"],"summary":"Declare a dependency","description":"Requires the profile-manager capability. `expectedVersion` must be null for a new declaration.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"value":{"type":"object","properties":{"subject":{"type":"string","enum":["profile","activity","perimeter"]},"perimeterItemId":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"activity":{"default":"","type":"string","maxLength":200},"criticality":{"default":"unknown","type":"string","enum":["high","medium","unknown","low"]},"concentration":{"default":null,"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"concentrationBase":{"default":null,"anyOf":[{"type":"string","enum":["purchase","sales","supply"]},{"type":"null"}]},"substitutability":{"default":"unknown","type":"string","enum":["easy","difficult","none_known","unknown"]},"soleSupplier":{"default":"unknown","type":"string","enum":["yes","no","unknown"]},"inventoryDays":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":36500},{"type":"null"}]},"inventoryDeclaredOn":{"default":null,"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"null"}]},"replacementDays":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":36500},{"type":"null"}]},"sensitivities":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","enum":["energy","materials","currency","regulation","transport"]}},"infrastructure":{"default":"","type":"string","maxLength":500},"notes":{"default":"","type":"string","maxLength":2000}},"required":["subject"],"additionalProperties":false}},"required":["expectedVersion","value"],"additionalProperties":false}}}},"responses":{"200":{"description":"All declared dependencies after the insert.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"version":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"value":{"type":"object","properties":{"subject":{"type":"string","enum":["profile","activity","perimeter"]},"perimeterItemId":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"activity":{"default":"","type":"string","maxLength":200},"criticality":{"default":"unknown","type":"string","enum":["high","medium","unknown","low"]},"concentration":{"default":null,"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"concentrationBase":{"default":null,"anyOf":[{"type":"string","enum":["purchase","sales","supply"]},{"type":"null"}]},"substitutability":{"default":"unknown","type":"string","enum":["easy","difficult","none_known","unknown"]},"soleSupplier":{"default":"unknown","type":"string","enum":["yes","no","unknown"]},"inventoryDays":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":36500},{"type":"null"}]},"inventoryDeclaredOn":{"default":null,"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"null"}]},"replacementDays":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":36500},{"type":"null"}]},"sensitivities":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","enum":["energy","materials","currency","regulation","transport"]}},"infrastructure":{"default":"","type":"string","maxLength":500},"notes":{"default":"","type":"string","maxLength":2000}},"required":["subject","perimeterItemId","activity","criticality","concentration","concentrationBase","substitutability","soleSupplier","inventoryDays","inventoryDeclaredOn","replacementDays","sensitivities","infrastructure","notes"],"additionalProperties":false},"recordedFrom":{"type":"string"},"author":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"declaredBy":{"type":"string","const":"client"}},"required":["id","version","value","recordedFrom","author","declaredBy"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Version conflict.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/dependencies/{id}":{"put":{"tags":["Client panel"],"summary":"Declare a new dependency version","description":"Requires the profile-manager capability. Close-and-insert against `expectedVersion`; the subject of a declaration is immutable.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"value":{"type":"object","properties":{"subject":{"type":"string","enum":["profile","activity","perimeter"]},"perimeterItemId":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"activity":{"default":"","type":"string","maxLength":200},"criticality":{"default":"unknown","type":"string","enum":["high","medium","unknown","low"]},"concentration":{"default":null,"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"concentrationBase":{"default":null,"anyOf":[{"type":"string","enum":["purchase","sales","supply"]},{"type":"null"}]},"substitutability":{"default":"unknown","type":"string","enum":["easy","difficult","none_known","unknown"]},"soleSupplier":{"default":"unknown","type":"string","enum":["yes","no","unknown"]},"inventoryDays":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":36500},{"type":"null"}]},"inventoryDeclaredOn":{"default":null,"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"null"}]},"replacementDays":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":36500},{"type":"null"}]},"sensitivities":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","enum":["energy","materials","currency","regulation","transport"]}},"infrastructure":{"default":"","type":"string","maxLength":500},"notes":{"default":"","type":"string","maxLength":2000}},"required":["subject"],"additionalProperties":false}},"required":["expectedVersion","value"],"additionalProperties":false}}}},"responses":{"200":{"description":"All declared dependencies after the write.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"version":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"value":{"type":"object","properties":{"subject":{"type":"string","enum":["profile","activity","perimeter"]},"perimeterItemId":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"activity":{"default":"","type":"string","maxLength":200},"criticality":{"default":"unknown","type":"string","enum":["high","medium","unknown","low"]},"concentration":{"default":null,"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"concentrationBase":{"default":null,"anyOf":[{"type":"string","enum":["purchase","sales","supply"]},{"type":"null"}]},"substitutability":{"default":"unknown","type":"string","enum":["easy","difficult","none_known","unknown"]},"soleSupplier":{"default":"unknown","type":"string","enum":["yes","no","unknown"]},"inventoryDays":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":36500},{"type":"null"}]},"inventoryDeclaredOn":{"default":null,"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"null"}]},"replacementDays":{"default":null,"anyOf":[{"type":"integer","minimum":0,"maximum":36500},{"type":"null"}]},"sensitivities":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","enum":["energy","materials","currency","regulation","transport"]}},"infrastructure":{"default":"","type":"string","maxLength":500},"notes":{"default":"","type":"string","maxLength":2000}},"required":["subject","perimeterItemId","activity","criticality","concentration","concentrationBase","substitutability","soleSupplier","inventoryDays","inventoryDeclaredOn","replacementDays","sensitivities","infrastructure","notes"],"additionalProperties":false},"recordedFrom":{"type":"string"},"author":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"declaredBy":{"type":"string","const":"client"}},"required":["id","version","value","recordedFrom","author","declaredBy"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"The expected version is stale; reload before saving.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/perimeter":{"get":{"tags":["Client panel"],"summary":"List the canonical perimeter","description":"Current perimeter versions including pending resolutions. `original_text` is immutable and preserved verbatim.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}}],"responses":{"200":{"description":"Perimeter items.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"originalText":{"type":"string"},"declaredType":{"type":"string","enum":["supplier","subsidiary","plant","material","position","country_focus"]},"status":{"type":"string","enum":["active","removed"]},"resolutionStatus":{"type":"string","enum":["pending","matched","created","rejected","ambiguous"]},"entityId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"externalId":{"anyOf":[{"type":"string"},{"type":"null"}]},"externalIdScheme":{"anyOf":[{"type":"string"},{"type":"null"}]},"declaredByParty":{"type":"string","enum":["client","operator"]},"recordedFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["id","workspaceId","originalText","declaredType","status","resolutionStatus","entityId","externalId","externalIdScheme","declaredByParty","recordedFrom","versionId"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}},"post":{"tags":["Client panel"],"summary":"Declare a perimeter item","description":"Requires the profile-manager capability. New items enter as `pending`; clients never resolve identities themselves.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"originalText":{"type":"string","minLength":1,"maxLength":500},"declaredType":{"type":"string","enum":["supplier","subsidiary","plant","material","position","country_focus"]}},"required":["originalText","declaredType"],"additionalProperties":false}}}},"responses":{"200":{"description":"Perimeter items after the declaration.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"originalText":{"type":"string"},"declaredType":{"type":"string","enum":["supplier","subsidiary","plant","material","position","country_focus"]},"status":{"type":"string","enum":["active","removed"]},"resolutionStatus":{"type":"string","enum":["pending","matched","created","rejected","ambiguous"]},"entityId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"externalId":{"anyOf":[{"type":"string"},{"type":"null"}]},"externalIdScheme":{"anyOf":[{"type":"string"},{"type":"null"}]},"declaredByParty":{"type":"string","enum":["client","operator"]},"recordedFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["id","workspaceId","originalText","declaredType","status","resolutionStatus","entityId","externalId","externalIdScheme","declaredByParty","recordedFrom","versionId"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/perimeter/{id}/remove":{"post":{"tags":["Client panel"],"summary":"Remove a perimeter item keeping history","description":"Requires the profile-manager capability. Closes the current version and inserts a `removed` one; nothing is deleted.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedVersion":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Perimeter items after the removal.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"originalText":{"type":"string"},"declaredType":{"type":"string","enum":["supplier","subsidiary","plant","material","position","country_focus"]},"status":{"type":"string","enum":["active","removed"]},"resolutionStatus":{"type":"string","enum":["pending","matched","created","rejected","ambiguous"]},"entityId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"externalId":{"anyOf":[{"type":"string"},{"type":"null"}]},"externalIdScheme":{"anyOf":[{"type":"string"},{"type":"null"}]},"declaredByParty":{"type":"string","enum":["client","operator"]},"recordedFrom":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["id","workspaceId","originalText","declaredType","status","resolutionStatus","entityId","externalId","externalIdScheme","declaredByParty","recordedFrom","versionId"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"The expected version is stale or already removed.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/preferences":{"get":{"tags":["Client panel"],"summary":"Read own preferences","description":"Personal preferences of the caller in this workspace; never another member's.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}}],"responses":{"200":{"description":"The caller's preferences, or null when unset.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"role":{"default":"other","type":"string","enum":["management","purchase","compliance","operations","other"]},"language":{"default":"en","type":"string","enum":["es","en"]},"timezone":{"type":"string","maxLength":100},"interests":{"default":[],"maxItems":8,"type":"array","items":{"type":"string","enum":["sanctions","regulation","logistics","energy","conflict","reputation","competition","opportunities"]}}},"required":["role","language","timezone","interests"],"additionalProperties":false},{"type":"null"}]}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}},"put":{"tags":["Client panel"],"summary":"Save own preferences","description":"Personal filtering only; preferences never change the shared profile or the base ranking. The IANA timezone is confirmed, not deduced.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"default":"other","type":"string","enum":["management","purchase","compliance","operations","other"]},"language":{"default":"en","type":"string","enum":["es","en"]},"timezone":{"type":"string","maxLength":100},"interests":{"default":[],"maxItems":8,"type":"array","items":{"type":"string","enum":["sanctions","regulation","logistics","energy","conflict","reputation","competition","opportunities"]}}},"required":["timezone"],"additionalProperties":false}}}},"responses":{"200":{"description":"The persisted preferences.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"role":{"default":"other","type":"string","enum":["management","purchase","compliance","operations","other"]},"language":{"default":"en","type":"string","enum":["es","en"]},"timezone":{"type":"string","maxLength":100},"interests":{"default":[],"maxItems":8,"type":"array","items":{"type":"string","enum":["sanctions","regulation","logistics","energy","conflict","reputation","competition","opportunities"]}}},"required":["role","language","timezone","interests"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/today":{"get":{"tags":["Client panel"],"summary":"Daily relevance feed (Hoy)","description":"Deterministic, explainable selection over eligible published data. Responses declare the cut, rule and profile versions, pending counts and honest coverage; a cursor pins pagination to a persisted snapshot.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["today","following"]}},{"name":"days","in":"query","required":false,"schema":{"type":"string","enum":["7","30","90"]}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"preferences","in":"query","required":false,"schema":{"type":"string","enum":["true"]}},{"name":"cursor","in":"query","required":false,"schema":{"description":"Opaque `<snapshotId>:<offset>` cursor pinning pagination to the same cut.","type":"string"}}],"responses":{"200":{"description":"A page of topics plus coverage state.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"snapshotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"cutoff":{"type":"string"},"profileVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"ruleVersion":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"materialVersion":{"type":"string"},"materialFingerprint":{"default":"","type":"string"},"sourceVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"title":{"type":"string"},"summary":{"type":"string"},"occurredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"type":"string"},"band":{"type":"string","enum":["high","normal","contextual"]},"materialChangedAt":{"type":"string"},"factVersion":{"default":"","type":"string"},"match":{"type":"string","enum":["direct","exposure","thematic"]},"criticality":{"type":"string","enum":["high","medium","unknown","low"]},"reasons":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"text":{"type":"string"},"itemId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"relationshipIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["code","text","itemId","relationshipIds"],"additionalProperties":false}},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["title","url"],"additionalProperties":false}},"ruleVersion":{"type":"string"},"profileVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"status":{"type":"string","enum":["pending","following","dismissed","closed"]},"stateVersion":{"type":"number"},"assignee":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"reviewed":{"type":"boolean"},"reviewedBy":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"novelty":{"type":"string","enum":["new","material_change","configuration","unchanged","withdrawn"]},"withdrawn":{"type":"boolean"},"knowledge":{"type":"string","const":"published_event"},"categories":{"default":[],"type":"array","items":{"type":"string","enum":["sanctions","regulation","logistics","energy","conflict","reputation","competition","opportunities"]}},"configurationVersions":{"default":[],"type":"array","items":{"type":"string"}},"verificationStatus":{"default":"unknown","type":"string","enum":["provisional","verified","unknown"]},"qualityStatus":{"default":"unknown","type":"string","enum":["clear","warning","disputed","unknown"]},"confidence":{"default":null,"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"paths":{"default":[],"type":"array","items":{"type":"object","properties":{"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"from":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"to":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"fromName":{"type":"string"},"toName":{"type":"string"}},"required":["versionId","from","to","type","fromName","toName"],"additionalProperties":false}}},"required":["id","materialVersion","materialFingerprint","sourceVersion","title","summary","occurredAt","publishedAt","band","materialChangedAt","factVersion","match","criticality","reasons","sources","ruleVersion","profileVersion","status","stateVersion","assignee","reviewed","reviewedBy","novelty","withdrawn","knowledge","categories","configurationVersions","verificationStatus","qualityStatus","confidence","paths"],"additionalProperties":false}},"total":{"type":"number"},"pending":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage":{"type":"object","properties":{"status":{"type":"string","enum":["covered","partial","stale","unavailable","not_configured"]},"reasons":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"sector":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastPublication":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastAttempt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSuccessfulIngestion":{"anyOf":[{"type":"string"},{"type":"null"}]},"cadence":{"anyOf":[{"type":"string"},{"type":"null"}]},"pendingIdentities":{"type":"number"},"corpusTruncated":{"type":"boolean"},"sources":{"default":[],"type":"array","items":{"type":"object","properties":{"datasetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"countries":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["covered","partial","stale","unavailable","not_configured"]},"scopes":{"type":"array","items":{"type":"string"}},"cadenceSeconds":{"type":"number"},"lastAttempt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSuccessfulIngestion":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["datasetId","name","countries","status","scopes","cadenceSeconds","lastAttempt","lastSuccessfulIngestion"],"additionalProperties":false}}},"required":["status","reasons","countries","sector","lastPublication","lastAttempt","lastSuccessfulIngestion","cadence","pendingIdentities","corpusTruncated","sources"],"additionalProperties":false},"filters":{"default":{"days":"7","category":null,"preferences":false},"type":"object","properties":{"days":{"type":"string","enum":["7","30","90"]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"preferences":{"type":"boolean"}},"required":["days","category","preferences"],"additionalProperties":false},"filteredOut":{"default":0,"type":"number"}},"required":["snapshotId","cutoff","profileVersion","ruleVersion","items","total","pending","nextCursor","coverage","filters","filteredOut"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/topics/{id}":{"get":{"tags":["Client panel"],"summary":"Read a topic at its current material version","description":"Re-evaluates eligibility before answering; opening a topic never marks it reviewed.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"The topic with the caller's check state.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"materialVersion":{"type":"string"},"materialFingerprint":{"default":"","type":"string"},"sourceVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"title":{"type":"string"},"summary":{"type":"string"},"occurredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"type":"string"},"band":{"type":"string","enum":["high","normal","contextual"]},"materialChangedAt":{"type":"string"},"factVersion":{"default":"","type":"string"},"match":{"type":"string","enum":["direct","exposure","thematic"]},"criticality":{"type":"string","enum":["high","medium","unknown","low"]},"reasons":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"text":{"type":"string"},"itemId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"relationshipIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["code","text","itemId","relationshipIds"],"additionalProperties":false}},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["title","url"],"additionalProperties":false}},"ruleVersion":{"type":"string"},"profileVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"status":{"type":"string","enum":["pending","following","dismissed","closed"]},"stateVersion":{"type":"number"},"assignee":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"reviewed":{"type":"boolean"},"reviewedBy":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"novelty":{"type":"string","enum":["new","material_change","configuration","unchanged","withdrawn"]},"withdrawn":{"type":"boolean"},"knowledge":{"type":"string","const":"published_event"},"categories":{"default":[],"type":"array","items":{"type":"string","enum":["sanctions","regulation","logistics","energy","conflict","reputation","competition","opportunities"]}},"configurationVersions":{"default":[],"type":"array","items":{"type":"string"}},"verificationStatus":{"default":"unknown","type":"string","enum":["provisional","verified","unknown"]},"qualityStatus":{"default":"unknown","type":"string","enum":["clear","warning","disputed","unknown"]},"confidence":{"default":null,"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"paths":{"default":[],"type":"array","items":{"type":"object","properties":{"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"from":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"to":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"fromName":{"type":"string"},"toName":{"type":"string"}},"required":["versionId","from","to","type","fromName","toName"],"additionalProperties":false}}},"required":["id","materialVersion","materialFingerprint","sourceVersion","title","summary","occurredAt","publishedAt","band","materialChangedAt","factVersion","match","criticality","reasons","sources","ruleVersion","profileVersion","status","stateVersion","assignee","reviewed","reviewedBy","novelty","withdrawn","knowledge","categories","configurationVersions","verificationStatus","qualityStatus","confidence","paths"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/topics/{id}/reviews":{"post":{"tags":["Client panel"],"summary":"Mark a material version as personally reviewed","description":"Per-user check bound to an exact material version; idempotent per idempotency key. Does not change the shared status.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"materialVersion":{"type":"string","minLength":1,"maxLength":160},"idempotencyKey":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["materialVersion","idempotencyKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"The topic after the check.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"materialVersion":{"type":"string"},"materialFingerprint":{"default":"","type":"string"},"sourceVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"title":{"type":"string"},"summary":{"type":"string"},"occurredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"type":"string"},"band":{"type":"string","enum":["high","normal","contextual"]},"materialChangedAt":{"type":"string"},"factVersion":{"default":"","type":"string"},"match":{"type":"string","enum":["direct","exposure","thematic"]},"criticality":{"type":"string","enum":["high","medium","unknown","low"]},"reasons":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"text":{"type":"string"},"itemId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"relationshipIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["code","text","itemId","relationshipIds"],"additionalProperties":false}},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["title","url"],"additionalProperties":false}},"ruleVersion":{"type":"string"},"profileVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"status":{"type":"string","enum":["pending","following","dismissed","closed"]},"stateVersion":{"type":"number"},"assignee":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"reviewed":{"type":"boolean"},"reviewedBy":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"novelty":{"type":"string","enum":["new","material_change","configuration","unchanged","withdrawn"]},"withdrawn":{"type":"boolean"},"knowledge":{"type":"string","const":"published_event"},"categories":{"default":[],"type":"array","items":{"type":"string","enum":["sanctions","regulation","logistics","energy","conflict","reputation","competition","opportunities"]}},"configurationVersions":{"default":[],"type":"array","items":{"type":"string"}},"verificationStatus":{"default":"unknown","type":"string","enum":["provisional","verified","unknown"]},"qualityStatus":{"default":"unknown","type":"string","enum":["clear","warning","disputed","unknown"]},"confidence":{"default":null,"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"paths":{"default":[],"type":"array","items":{"type":"object","properties":{"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"from":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"to":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"fromName":{"type":"string"},"toName":{"type":"string"}},"required":["versionId","from","to","type","fromName","toName"],"additionalProperties":false}}},"required":["id","materialVersion","materialFingerprint","sourceVersion","title","summary","occurredAt","publishedAt","band","materialChangedAt","factVersion","match","criticality","reasons","sources","ruleVersion","profileVersion","status","stateVersion","assignee","reviewed","reviewedBy","novelty","withdrawn","knowledge","categories","configurationVersions","verificationStatus","qualityStatus","confidence","paths"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"The material version was superseded; reload the topic.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/topics/{id}/actions":{"post":{"tags":["Client panel"],"summary":"Apply a shared follow-up transition","description":"Requires the collaborator capability. Follow/unfollow/dismiss/close/reopen/assign with expected shared-state version; dismissal requires a reason. Append-only history.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"materialVersion":{"type":"string","minLength":1,"maxLength":160},"action":{"type":"string","enum":["follow","unfollow","dismiss","close","reopen","assign"]},"reason":{"default":"","type":"string","maxLength":2000},"assignee":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"idempotencyKey":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["expectedVersion","materialVersion","action","idempotencyKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"The topic after the transition.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"materialVersion":{"type":"string"},"materialFingerprint":{"default":"","type":"string"},"sourceVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"title":{"type":"string"},"summary":{"type":"string"},"occurredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"type":"string"},"band":{"type":"string","enum":["high","normal","contextual"]},"materialChangedAt":{"type":"string"},"factVersion":{"default":"","type":"string"},"match":{"type":"string","enum":["direct","exposure","thematic"]},"criticality":{"type":"string","enum":["high","medium","unknown","low"]},"reasons":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"text":{"type":"string"},"itemId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"relationshipIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["code","text","itemId","relationshipIds"],"additionalProperties":false}},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["title","url"],"additionalProperties":false}},"ruleVersion":{"type":"string"},"profileVersion":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"status":{"type":"string","enum":["pending","following","dismissed","closed"]},"stateVersion":{"type":"number"},"assignee":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"reviewed":{"type":"boolean"},"reviewedBy":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"novelty":{"type":"string","enum":["new","material_change","configuration","unchanged","withdrawn"]},"withdrawn":{"type":"boolean"},"knowledge":{"type":"string","const":"published_event"},"categories":{"default":[],"type":"array","items":{"type":"string","enum":["sanctions","regulation","logistics","energy","conflict","reputation","competition","opportunities"]}},"configurationVersions":{"default":[],"type":"array","items":{"type":"string"}},"verificationStatus":{"default":"unknown","type":"string","enum":["provisional","verified","unknown"]},"qualityStatus":{"default":"unknown","type":"string","enum":["clear","warning","disputed","unknown"]},"confidence":{"default":null,"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"paths":{"default":[],"type":"array","items":{"type":"object","properties":{"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"from":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"to":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"fromName":{"type":"string"},"toName":{"type":"string"}},"required":["versionId","from","to","type","fromName","toName"],"additionalProperties":false}}},"required":["id","materialVersion","materialFingerprint","sourceVersion","title","summary","occurredAt","publishedAt","band","materialChangedAt","factVersion","match","criticality","reasons","sources","ruleVersion","profileVersion","status","stateVersion","assignee","reviewed","reviewedBy","novelty","withdrawn","knowledge","categories","configurationVersions","verificationStatus","qualityStatus","confidence","paths"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Concurrent change; reload before retrying with a new key.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/members":{"get":{"tags":["Client panel"],"summary":"List workspace members and capabilities","description":"Membership and client capabilities are operator-managed; there is no self-elevation.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}}],"responses":{"200":{"description":"Members.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"capability":{"type":"string","enum":["reader","collaborator","profile_manager"]},"role":{"type":"string"}},"required":["userId","capability","role"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/sectors":{"get":{"tags":["Client panel"],"summary":"List the published sector catalogue","description":"Only currently published sector/industry entities; free text stays pending classification.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}}],"responses":{"200":{"description":"Sector catalogue.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["id","versionId","name"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/reports":{"get":{"tags":["Client panel"],"summary":"List delivered reports","description":"Only delivered frozen report versions; drafts and reviews are never listed.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}}],"responses":{"200":{"description":"Delivered reports.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string"},"deliveredAt":{"type":"string"},"asOf":{"type":"string"}},"required":["id","versionId","title","deliveredAt","asOf"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/client/workspaces/{workspaceId}/reports/{id}":{"get":{"tags":["Client panel"],"summary":"Open a delivered report","description":"Hash-verified reopening of the frozen bundle; the report is never recalculated and opening it marks nothing reviewed. Storage keys are never exposed.","security":[{"bearerAuth":[]}],"x-rate-limit-class":"authenticated","parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Client workspace the caller belongs to."}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"The verified report bundle.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"reportId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"asOf":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"title":{"type":"string","minLength":1},"horizons":{"default":[],"type":"array","items":{"type":"string","minLength":1}},"selection":{"minItems":1,"type":"array","items":{"type":"object","properties":{"perimeterItemId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"originalText":{"type":"string"},"declaredType":{"type":"string","enum":["supplier","subsidiary","plant","material","position","country_focus"]},"resolutionStatus":{"type":"string","enum":["pending","matched","created","rejected","ambiguous"]},"entityId":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"externalId":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["perimeterItemId","originalText","declaredType","resolutionStatus","entityId","externalId"],"additionalProperties":false}},"claims":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"kind":{"type":"string","enum":["fact","verified_exposure","inferred_impact"]},"statement":{"type":"string","minLength":1},"confidence":{"default":null,"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"mechanism":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"evidence":{"minItems":1,"type":"array","items":{"type":"object","properties":{"sourceTitle":{"type":"string","minLength":1},"url":{"default":null,"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"locator":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"type":"string","minLength":1},"excerpt":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["sourceTitle","url","locator","summary","excerpt"],"additionalProperties":false}}},"required":["id","kind","statement","confidence","mechanism","evidence"],"additionalProperties":false}},"projections":{"default":[],"type":"array","items":{"type":"object","properties":{"horizon":{"type":"string","minLength":1},"method":{"type":"string","minLength":1},"assumptions":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"uncertainty":{"type":"string","minLength":1},"derivedFromClaimIds":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"statement":{"type":"string","minLength":1}},"required":["horizon","method","assumptions","uncertainty","derivedFromClaimIds","statement"],"additionalProperties":false}},"unknowns":{"default":[],"type":"array","items":{"type":"string","minLength":1}}},"required":["reportId","versionId","workspaceId","asOf","title","horizons","selection","claims","projections","unknowns"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"No valid session.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Membership without the required client capability.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Workspace or object inaccessible to this member.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Bundle storage unavailable or failed verification; fails loudly.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","IDEMPOTENCY_CONFLICT","STALE_REVISION","CONFLICT_EXISTS","VALIDITY_REVIEW_REQUIRED","PUBLICATION_GATE_FAILED","USE_CLAIM_CORRECTION","IDENTITY_GROUP_UNSUPPORTED","DEPENDENT_IDENTITY_CHANGE","PREDICATE_ALREADY_EXISTS","INSUFFICIENT_EXAMPLES","CATALOG_NOT_DEPLOYED","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"details":{"default":[],"type":"array","items":{}}},"required":["code","message","requestId","details"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}}}}