{"openapi":"3.0.3","info":{"title":"Chronum API","version":"2026-10-29","description":"Chronum is an evidence-linked, append-only record of historical events: what happened, when, where, who was involved, what sources say, and how sure anyone is. Every write adds a row; nothing is ever updated or deleted. A change is a new version of the same record, and every version stays readable. Build 0.12.2.","termsOfService":"https://chronumapi.com/v1/docs","x-build":"0.12.2","x-region-policy":"Chronum is not offered where a legal right to be forgotten conflicts with an append-only record (the European Union and European Economic Area, the United Kingdom and crown dependencies, Switzerland). Callers from those regions receive 451 region_not_served. The country is decided on this server from the caller's connection address using the DB-IP Lite country database (db-ip.com), used under the Creative Commons Attribution 4.0 licence. This page and the health address are never blocked."},"servers":[{"url":"https://chronumapi.com"}],"paths":{"/v1/health":{"get":{"summary":"Service status: database, schema migration number, build, region policy dataset in use. Never blocked.","tags":["Service"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"database":{"type":"string"},"insert_only":{"type":"boolean"},"region_policy":{"type":"object","properties":{"blocked_regions":{"type":"integer"},"dataset":{"type":"string"},"dataset_built":{"type":"string"},"lookup_source":{"type":"string"}}},"schema_migration":{"type":"integer"},"status":{"type":"string"}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/timeframes":{"get":{"summary":"The time reference frames the server knows (Gregorian UTC, Julian calendar, astronomical year, years before present, Mars sol date, mission seconds, and two it cannot convert), each naming the conversion the server applies.","tags":["Service"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"time_frames":{"type":"array","items":{"type":"object","properties":{"algorithm_version":{"type":"string"},"base_unit":{"type":"string"},"body":{"type":"string"},"conversion_algorithm":{"type":"string"},"epoch_description":{"type":"string"},"frame_code":{"type":"string"},"leap_second_treatment":{"type":"string"},"recorded_at":{"type":"string"},"time_frame_id":{"type":"string"},"validity_notes":{"type":"string"},"version_no":{"type":"integer"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/spatialframes":{"get":{"summary":"The spatial reference frames (Earth WGS84, lunar, Martian, vessel-local and more).","tags":["Service"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"spatial_frames":{"type":"array","items":{"type":"object","properties":{"axes_description":{"type":"string"},"body":{"type":"string"},"datum_or_origin":{"type":"string"},"epoch_description":{"type":"string"},"frame_code":{"type":"string"},"recorded_at":{"type":"string"},"spatial_frame_id":{"type":"string"},"transform_notes":{"type":"string"},"units":{"type":"string"},"version_no":{"type":"integer"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/events":{"get":{"summary":"List events visible to you, in order of their latest change. status, q (title, summary), limit, cursor.","tags":["Events"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"events":{"type":"array","items":[]}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"nullable":true},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]},"post":{"summary":"Create an event. Fields: title (required), summary, visibility, circle_id. Scope submit.","tags":["Events"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/events/{id}":{"get":{"summary":"One event with its current time positions, place positions and links.","tags":["Events"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"event":{"type":"object","properties":{"change_reason":{"type":"string"},"event_id":{"type":"string"},"event_status":{"type":"string"},"links":{"type":"object","properties":{"claims":{"type":"string"},"versions":{"type":"string"}}},"owner_actor_id":{"type":"string"},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"recorded_via_application_id":{"type":"string"},"retraction_reason":{"nullable":true},"spatial_positions":{"type":"array","items":{"type":"object","properties":{"altitude_m":{"nullable":true},"body":{"type":"string"},"coord_x":{"nullable":true},"coord_y":{"nullable":true},"coord_z":{"nullable":true},"coordinate_kind":{"type":"string"},"geometry_kind":{"type":"string"},"geometry_wkt":{"nullable":true},"inside_entity_id":{"nullable":true},"latitude":{"type":"string"},"longitude":{"type":"string"},"observation_time_note":{"nullable":true},"place_label":{"type":"string"},"position_role":{"type":"string"},"source_id":{"nullable":true},"spatial_frame_id":{"type":"string"},"spatial_position_id":{"type":"string"},"uncertainty_m":{"type":"string"},"version_no":{"type":"integer"}}}},"summary":{"nullable":true},"supersedes_row_id":{"type":"integer"},"temporal_positions":{"type":"array","items":{"type":"object","properties":{"algorithm_version":{"type":"string"},"begin_earliest_s":{"type":"string"},"begin_latest_s":{"type":"string"},"calendar":{"nullable":true},"certainty":{"type":"string"},"conversion_algorithm":{"type":"string"},"conversion_note":{"type":"string"},"duration_s":{"nullable":true},"earliest_s":{"type":"string"},"end_earliest_s":{"type":"string"},"end_latest_s":{"type":"string"},"inside_temporal_position_id":{"nullable":true},"latest_s":{"type":"string"},"original_value":{"type":"string"},"position_role":{"type":"string"},"precision_code":{"type":"string"},"source_id":{"type":"string"},"source_mark":{"nullable":true},"temporal_position_id":{"type":"string"},"time_frame_id":{"type":"string"},"time_scale":{"nullable":true},"version_no":{"type":"integer"},"written":{"type":"string"}}}},"title":{"type":"string"},"version_no":{"type":"integer"},"version_row_id":{"type":"integer"},"visibility":{"type":"string"}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/events/{id}/versions":{"get":{"summary":"Every version of an event, oldest first, with who wrote each and why.","tags":["Events"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"event_id":{"type":"string"},"versions":{"type":"array","items":{"type":"object","properties":{"change_reason":{"type":"string"},"event_id":{"type":"string"},"event_status":{"type":"string"},"owner_actor_id":{"type":"string"},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"recorded_via_application_id":{"type":"string"},"retraction_reason":{"nullable":true},"summary":{"nullable":true},"supersedes_row_id":{"type":"integer"},"title":{"type":"string"},"version_no":{"type":"integer"},"version_row_id":{"type":"integer"},"visibility":{"type":"string"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"post":{"summary":"Append a new version of an event: any of title, summary, visibility, circle_id, event_status (reviewers only), retraction_reason; change_reason required; expected_version optional.","tags":["Events"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/events/{id}/claims":{"get":{"summary":"The claims attached to an event that are visible to you.","tags":["Events"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"claims":{"type":"array","items":{"type":"object","properties":{"claim_id":{"type":"string"},"claim_status":{"type":"string"},"links":{"type":"object","properties":{"claim":{"type":"string"}}},"object_value":{"type":"string"},"predicate":{"type":"string"},"qualifiers":{"type":"object","properties":{"pilot":{"type":"string"}}},"recorded_at":{"type":"string"},"retraction_reason":{"nullable":true},"subject_id":{"type":"string"},"subject_kind":{"type":"string"},"version_no":{"type":"integer"},"visibility":{"type":"string"}}}},"event_id":{"type":"string"}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/entities/{id}":{"get":{"summary":"One entity with its aliases, outside identifiers and relationships. A relationship is listed only when the record at its other end is also visible to you.","tags":["Entities and relationships"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entity":{"type":"object","properties":{"aliases":{"type":"array","items":{"type":"string"}},"canonical_label":{"type":"string"},"change_reason":{"type":"string"},"circle_id":{"nullable":true},"description":{"type":"string"},"entity_id":{"type":"string"},"entity_status":{"type":"string"},"entity_type":{"type":"string"},"external_ids":{"type":"object","properties":{"wikidata":{"type":"string"}}},"is_living_private_person":{"type":"boolean"},"merged_into_entity_id":{"nullable":true},"owner_actor_id":{"type":"string"},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"relationships":{"type":"array","items":{"type":"object","properties":{"from_id":{"type":"string"},"from_kind":{"type":"string"},"relation_code":{"type":"string"},"relationship_id":{"type":"string"},"relationship_status":{"type":"string"},"source_id":{"nullable":true},"time_bounds_note":{"nullable":true},"to_id":{"type":"string"},"to_kind":{"type":"string"},"version_no":{"type":"integer"}}}},"row_id":{"type":"integer"},"supersedes_row_id":{"type":"integer"},"version_no":{"type":"integer"},"visibility":{"type":"string"}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/claims/{id}":{"get":{"summary":"One claim with its evidence links and reviews.","tags":["Claims and evidence"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"claim":{"type":"object","properties":{"change_reason":{"type":"string"},"claim_id":{"type":"string"},"claim_status":{"type":"string"},"event_id":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","properties":{"canonical_uri":{"type":"string"},"evidence_link_id":{"type":"string"},"excerpt":{"type":"string"},"link_status":{"type":"string"},"locator":{"type":"string"},"relation":{"type":"string"},"source_id":{"type":"string"},"source_title":{"type":"string"},"source_type":{"type":"string"},"version_no":{"type":"integer"}}}},"object_value":{"type":"string"},"owner_actor_id":{"type":"string"},"predicate":{"type":"string"},"qualifiers":{"type":"object","properties":{"pilot":{"type":"string"}}},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"retraction_reason":{"nullable":true},"reviews":{"type":"array","items":{"type":"object","properties":{"decision":{"type":"string"},"notes":{"type":"string"},"policy_version":{"type":"string"},"recorded_at":{"type":"string"},"review_id":{"type":"string"},"reviewer_actor_id":{"type":"string"}}}},"subject_id":{"type":"string"},"subject_kind":{"type":"string"},"version_no":{"type":"integer"},"visibility":{"type":"string"}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/sources/{id}":{"get":{"summary":"One source and the claims it is cited by.","tags":["Sources"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"type":"object","properties":{"archival_locator":{"nullable":true},"canonical_uri":{"type":"string"},"change_reason":{"type":"string"},"cited_by":{"type":"array","items":{"type":"object","properties":{"claim_id":{"type":"string"},"link_status":{"type":"string"},"locator":{"type":"string"},"relation":{"type":"string"}}}},"creator":{"nullable":true},"owner_actor_id":{"type":"string"},"publisher":{"type":"string"},"recorded_at":{"type":"string"},"rights_note":{"nullable":true},"source_date_note":{"nullable":true},"source_id":{"type":"string"},"source_type":{"type":"string"},"title":{"type":"string"},"version_no":{"type":"integer"},"visibility":{"type":"string"}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/changes":{"get":{"summary":"The change feed: row-ordered additions across record kinds. cursor is the last row_id you saw.","tags":["Change feed"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"changes":{"type":"array","items":{"type":"object","properties":{"event_status":{"type":"string"},"id":{"type":"string"},"kind":{"type":"string"},"recorded_at":{"type":"string"},"row_id":{"type":"integer"},"version_no":{"type":"integer"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"next_cursor":{"type":"integer"},"note":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/events/{id}/time":{"post":{"summary":"Add a time position to your event. Give time_frame_id, original_value (the source's own words) and written, a form the server can read; the server then works out the four limits (begin_earliest_s, begin_latest_s, end_earliest_s, end_latest_s), records the mark on the source (~ approximate, ? uncertain, % both), the algorithm and its version, and suggests precision_code and certainty, which you may set yourself. Calendar frames take the Extended Date/Time Format: 1903, 1903-12-17, 1903-12-17T10:35:00Z, 1903~, 190X, -0100, Y-65000000, a span A/B (started in A, ended in B; ../B and A/.. open one end), a set [A..B] (sometime between), [..B] (B or earlier), [A..]. Years before present, Mars sol dates and mission seconds take a number or A/B; mission seconds also need epoch; years before present may add plus_minus. Optional duration_s says how long the period lasted. no_date_clues: true stores the widest defensible limits instead. For frames the server cannot convert (cosmological_model, unknown) give the four limits yourself. inside_temporal_position_id borrows the limits of another time position (a photo sometime during a life): the period can start no earlier and end no later than that one could; written and duration_s narrow it further. Also position_role, source_id.","tags":["Time and place"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/events/{id}/place":{"post":{"summary":"Add a place position: spatial_frame_id, body, coordinate_kind, latitude/longitude or coord_x/y/z with uncertainty_m (required for coordinates and more than zero: a point is a small circle), or coordinate_kind named_place with inside_entity_id (a place record; the place's shape valid at the event's time is the limit) and place_label; position_role, source_id.","tags":["Time and place"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/time/{tid}/versions":{"post":{"summary":"New version of a time position (owner of its event, or a reviewer). A new written value is read again and the limits recomputed; every earlier version stays. If other time positions borrow their limits from this one and its limits change, they are flagged for review (meta.borrowers_flagged). Send inside_temporal_position_id null to stop borrowing.","tags":["Time and place"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"tid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/place/{sid}/versions":{"post":{"summary":"New version of a place position (owner of its event, or a reviewer).","tags":["Time and place"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/sources":{"post":{"summary":"Create a source: title, source_type (original_artifact, contemporary_testimony, later_scholarship, institutional_summary, machine_generated, personal_recollection, other), canonical_uri, creator, publisher, archival_locator, rights_note, visibility.","tags":["Sources"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}},"get":{"summary":"List sources visible to you. source_type, q (title, creator, publisher), limit, cursor.","tags":["Sources"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"object","properties":{"canonical_uri":{"nullable":true},"creator":{"nullable":true},"links":{"type":"object","properties":{"self":{"type":"string"}}},"publisher":{"nullable":true},"recorded_at":{"type":"string"},"source_id":{"type":"string"},"source_type":{"type":"string"},"title":{"type":"string"},"version_no":{"type":"integer"},"visibility":{"type":"string"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"nullable":true},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/sources/{id}/versions":{"post":{"summary":"New version of a source.","tags":["Sources"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/events/{eid}/claims":{"post":{"summary":"Add a claim to your event: predicate, object_value, qualifiers (object), visibility. Claims start as draft; submitted is the owner's signal that review may begin.","tags":["Claims and evidence"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"eid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/claims/{id}/versions":{"post":{"summary":"New version of a claim: object_value, qualifiers, visibility, claim_status (submitted by the owner; supported, disputed, retracted by review only).","tags":["Claims and evidence"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/claims/{id}/evidence":{"post":{"summary":"Link a source to your claim: source_id, relation (supports, contradicts, mentions), locator, excerpt. Links start proposed.","tags":["Claims and evidence"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/evidence/{lid}/versions":{"post":{"summary":"New version of an evidence link: locator, excerpt, link_status (accepted or rejected by a reviewer).","tags":["Claims and evidence"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"lid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/reviews":{"post":{"summary":"Record a review: subject_kind (event, claim, relationship...), subject_id, decision (approve, dispute, retract, restore), policy_version, notes, retraction_reason when retracting, expected_version. Scope review. You cannot review your own record.","tags":["Reviews"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["review"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/media/upload-requests":{"post":{"summary":"Ask for an upload address: mime_type, byte_size, original_filename, event_id, visibility, authenticity_class (original_artifact, restored, reconstructed, synthetic_depiction), transformation_note (required for anything not original). Returns a signed PUT address valid 15 minutes and the pending asset id.","tags":["Media"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/media/{id}/confirm":{"post":{"summary":"After uploading, confirm with the sha256 you computed. The server checks the stored size, re-reads files up to 100 MB and verifies the hash, then marks the asset stored.","tags":["Media"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/media/{id}/versions":{"post":{"summary":"New version of a media asset: visibility, rights_note, authenticity fields, asset_status (unpublished by the owner; retracted by review only).","tags":["Media"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/media/{id}":{"get":{"summary":"One media asset. When stored and visible to you, includes a signed download address valid 15 minutes. 410 with the reason when unpublished or retracted.","tags":["Media"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"media_asset":{"type":"object","properties":{"asset_status":{"type":"string"},"authenticity_class":{"type":"string"},"byte_size":{"type":"integer"},"capture_metadata":{"nullable":true},"change_reason":{"type":"string"},"circle_id":{"nullable":true},"derived_from_media_asset_id":{"nullable":true},"event_id":{"type":"string"},"hash_verified":{"type":"integer"},"media_asset_id":{"type":"string"},"media_type":{"type":"string"},"mime_type":{"type":"string"},"original_filename":{"type":"string"},"owner_actor_id":{"type":"string"},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"retraction_reason":{"nullable":true},"rights_note":{"nullable":true},"row_id":{"type":"integer"},"sha256":{"nullable":true},"storage_etag":{"nullable":true},"supersedes_row_id":{"nullable":true},"transformation_note":{"nullable":true},"uploader_consent_note":{"nullable":true},"version_no":{"type":"integer"},"visibility":{"type":"string"}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"note":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/entities":{"post":{"summary":"Create an entity: entity_type, canonical_label, aliases (list), external_ids (object), description, is_living_private_person, visibility, circle_id.","tags":["Entities and relationships"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}},"get":{"summary":"List entities visible to you. entity_type, q (label, aliases, description), limit, cursor.","tags":["Entities and relationships"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entities":{"type":"array","items":{"type":"object","properties":{"aliases":{"type":"array","items":{"type":"string"}},"canonical_label":{"type":"string"},"entity_id":{"type":"string"},"entity_status":{"type":"string"},"entity_type":{"type":"string"},"is_living_private_person":{"type":"boolean"},"links":{"type":"object","properties":{"self":{"type":"string"}}},"recorded_at":{"type":"string"},"version_no":{"type":"integer"},"visibility":{"type":"string"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"nullable":true},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/entities/{id}/versions":{"post":{"summary":"New version of an entity, including entity_status merged (with merged_into_entity_id) or retracted (review only).","tags":["Entities and relationships"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/relationships":{"post":{"summary":"Relate two records: from_kind, from_id, relation_code (lowercase code such as participated_in, located_at, depicts, part_of), to_kind, to_id, time_bounds_note, source_id. Both ends must be visible to you.","tags":["Entities and relationships"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}},"get":{"summary":"List relationships whose BOTH ends are visible to you: from_kind with from_id, to_kind with to_id (an id needs its kind), relation_code, relationship_status (retracted ones are listed only when you ask for that status), limit, cursor. Each row links to both ends.","tags":["Entities and relationships"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"relationships":{"type":"array","items":{"type":"object","properties":{"from_id":{"type":"string"},"from_kind":{"type":"string"},"links":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}}},"recorded_at":{"type":"string"},"relation_code":{"type":"string"},"relationship_id":{"type":"string"},"relationship_status":{"type":"string"},"source_id":{"nullable":true},"time_bounds_note":{"nullable":true},"to_id":{"type":"string"},"to_kind":{"type":"string"},"version_no":{"type":"integer"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"nullable":true},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/relationships/{rid}/versions":{"post":{"summary":"New version of a relationship (its first author or a reviewer). Status changes need the review scope.","tags":["Entities and relationships"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"rid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/carettags":{"post":{"summary":"Create or find a tag: literal_tag starting with ^. Returns 201 for a new tag or 200 with the existing one for the same normalized key.","tags":["Caret tags"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}},"get":{"summary":"List caret tags you may know of: a reviewer or admin sees every tag; anyone else sees tags they created and tags on at least one record visible to them. q (part of the tag, with or without ^), limit, cursor.","tags":["Caret tags"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"caret_tags":{"type":"array","items":{"type":"object","properties":{"caret_tag_id":{"type":"string"},"links":{"type":"object","properties":{"self":{"type":"string"}}},"literal_tag":{"type":"string"},"namespace_note":{"nullable":true},"normalized_key":{"type":"string"},"recorded_at":{"type":"string"},"tag_status":{"type":"string"},"version_no":{"type":"integer"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"nullable":true},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/carettags/{key}":{"get":{"summary":"A tag by its literal or normalized key, with the subjects it is on that are visible to you.","tags":["Caret tags"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"caret_tag":{"type":"object","properties":{"caret_tag_id":{"type":"string"},"change_reason":{"type":"string"},"literal_tag":{"type":"string"},"merged_into_caret_tag_id":{"nullable":true},"namespace_note":{"nullable":true},"normalized_key":{"type":"string"},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"row_id":{"type":"integer"},"subjects":{"type":"array","items":[]},"supersedes_row_id":{"nullable":true},"tag_status":{"type":"string"},"version_no":{"type":"integer"}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/carettags/{id}/assignments":{"post":{"summary":"Put a tag on your record: subject_kind (event, media_asset, flash_group, entity), subject_id. 409 if already on it.","tags":["Caret tags"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/assignments/{aid}/versions":{"post":{"summary":"Remove or restore a tag assignment: assignment_status (active, removed), change_reason.","tags":["Caret tags"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"aid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/events/{eid}/flashgroups":{"post":{"summary":"Propose a flash group for your event: grouping_rule_note, temporal_tolerance_s, spatial_tolerance_m.","tags":["Flash groups"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"eid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/flashgroups/{id}":{"get":{"summary":"A flash group with its members, when its event is visible to you.","tags":["Flash groups"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"flash_group":{"type":"object","properties":{"change_reason":{"type":"string"},"event_id":{"type":"string"},"flash_group_id":{"type":"string"},"group_status":{"type":"string"},"grouping_rule_note":{"type":"string"},"links":{"type":"object","properties":{"event":{"type":"string"}}},"members":{"type":"array","items":[]},"owner_actor_id":{"type":"string"},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"row_id":{"type":"integer"},"spatial_tolerance_m":{"type":"string"},"supersedes_row_id":{"nullable":true},"temporal_tolerance_s":{"type":"string"},"version_no":{"type":"integer"}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/flashgroups/{id}/versions":{"post":{"summary":"New version of a flash group (owner or reviewer); group_status changes need review.","tags":["Flash groups"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/flashgroups/{id}/members":{"post":{"summary":"Propose your clip as a member: media_asset_id, viewpoint_note, estimated_offset_ms, sync_uncertainty_ms. Confirmation is a reviewer's act.","tags":["Flash groups"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/flashgroupmembers/{mid}/versions":{"post":{"summary":"New version of a membership: membership_status (proposed, confirmed by review, disputed with membership_evidence, removed).","tags":["Flash groups"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"mid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/circles":{"post":{"summary":"Create a circle: circle_name.","tags":["Circles"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/circles/{id}":{"get":{"summary":"A circle and its active members (owner or member).","tags":["Circles"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"circle":{"type":"object","properties":{"change_reason":{"type":"string"},"circle_id":{"type":"string"},"circle_name":{"type":"string"},"circle_status":{"type":"string"},"members":{"type":"array","items":[]},"owner_actor_id":{"type":"string"},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"row_id":{"type":"integer"},"supersedes_row_id":{"nullable":true},"version_no":{"type":"integer"}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/circles/{id}/versions":{"post":{"summary":"New version of a circle: circle_name, circle_status.","tags":["Circles"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/circles/{id}/members":{"post":{"summary":"Add a member (owner only): member_actor_id.","tags":["Circles"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/circlemembers/{mid}/versions":{"post":{"summary":"Leave or remove: membership_status removed (the member or the owner). Only the owner can re-add.","tags":["Circles"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"mid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/keyrequests":{"post":{"summary":"Ask for a key, no key needed: requester_name, requester_email, organization, application_name, intended_use (20 to 2000 characters), requested_scopes (submit only). Limits: 3 pending per email, 5 per address per day.","tags":["Key requests"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}},"get":{"summary":"The review queue by status (pending, approved, denied, withdrawn). Scope admin.","tags":["Key requests"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"key_requests":{"type":"array","items":{"type":"object","properties":{"application_name":{"type":"string"},"decided_at":{"type":"string"},"decided_by_actor_id":{"type":"string"},"decision_note":{"type":"string"},"granted_scopes":{"nullable":true},"intended_use":{"type":"string"},"key_request_id":{"type":"string"},"links":{"type":"object","properties":{"self":{"type":"string"}}},"organization":{"type":"string"},"request_status":{"type":"string"},"requested_at":{"type":"string"},"requested_scopes":{"type":"array","items":{"type":"string"}},"requester_email":{"type":"string"},"requester_name":{"type":"string"},"resulting_actor_id":{"nullable":true},"resulting_api_key_id":{"nullable":true},"resulting_application_id":{"nullable":true},"version_no":{"type":"integer"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"type":"integer"},"request_id":{"type":"string"},"server_time":{"type":"string"},"status":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["admin"]}]}},"/v1/keyrequests/{id}":{"get":{"summary":"Status of a request by its id, for the requester. Shows the decision note, never the key.","tags":["Key requests"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"key_request":{"type":"object","properties":{"application_name":{"type":"string"},"decided_at":{"type":"string"},"decision_note":{"type":"string"},"granted_scopes":{"type":"array","items":{"type":"string"}},"key_request_id":{"type":"string"},"links":{"type":"object","properties":{"self":{"type":"string"}}},"organization":{"type":"string"},"request_status":{"type":"string"},"requested_at":{"type":"string"},"requested_scopes":{"type":"array","items":{"type":"string"}},"requester_name":{"type":"string"},"version_no":{"type":"integer"}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/keyrequests/{id}/decisions":{"post":{"summary":"Decide: decision (approve, deny), decision_note (required to deny), granted_scopes (submit, review), trust_tier, expires_at, expected_version. On approve the response carries the key once. Scope admin.","tags":["Key requests"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["admin"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/claims":{"get":{"summary":"List claims visible to you. claim_status, predicate (exact code), event_id, q (predicate, value), limit, cursor.","tags":["Claims and evidence"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"claims":{"type":"array","items":{"type":"object","properties":{"claim_id":{"type":"string"},"claim_status":{"type":"string"},"event_id":{"type":"string"},"links":{"type":"object","properties":{"self":{"type":"string"}}},"object_value":{"type":"string"},"predicate":{"type":"string"},"qualifiers":{"nullable":true},"recorded_at":{"type":"string"},"subject_id":{"type":"string"},"subject_kind":{"type":"string"},"version_no":{"type":"integer"},"visibility":{"type":"string"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"nullable":true},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/search":{"get":{"summary":"Search events, entities, sources and claims at once: q (required), kinds (comma list, default all four), limit. Matches whole words and word beginnings: every word of 3 or more letters in q must appear, and very common words such as \"the\" are ignored; a q with no such word falls back to matching the text anywhere. Entity aliases always match anywhere. Most recently changed matches first, only those visible to you; meta.truncated says whether there were more. For further pages use that kind's list address with the same q (lists match the text anywhere).","tags":["Search"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"label":{"type":"string"},"links":{"type":"object","properties":{"self":{"type":"string"}}},"recorded_at":{"type":"string"},"status":{"type":"string"},"visibility":{"type":"string"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"kinds":{"type":"array","items":{"type":"string"}},"limit":{"type":"integer"},"request_id":{"type":"string"},"server_time":{"type":"string"},"truncated":{"type":"boolean"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/keyrequests/{id}/withdrawals":{"post":{"summary":"Withdraw your own pending request: withdraw_secret (returned once when you submitted), reason. No key needed.","tags":["Key requests"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/keys":{"get":{"summary":"Your keys (keys of applications you own, or issued on your behalf): id, scopes, state (active, expired, revoked), expiry, and which one you are calling with. status: active (default), expired, revoked, all. Never shows a key value or fingerprint.","tags":["Your keys"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"object","properties":{"api_key_id":{"type":"string"},"application_id":{"type":"string"},"application_name":{"type":"string"},"created_at":{"type":"string"},"expires_at":{"nullable":true},"is_this_key":{"type":"boolean"},"key_prefix":{"type":"string"},"key_status":{"type":"string"},"last_changed_at":{"type":"string"},"links":{"type":"object","properties":{"revocations":{"type":"string"},"rotations":{"type":"string"}}},"on_behalf_of_actor_id":{"type":"string"},"permission_scopes":{"type":"array","items":{"type":"string"}},"state":{"type":"string"},"version_no":{"type":"integer"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"type":"integer"},"request_id":{"type":"string"},"server_time":{"type":"string"},"status":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["key"]}]}},"/v1/keys/{id}/rotations":{"post":{"summary":"Replace one of your active keys with a new one carrying the same scopes and expiry; the new key is in this response only. overlap_hours (0 to 72, default 0) keeps the old key working that long so you can switch over; 0 revokes it at once. reason optional.","tags":["Your keys"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["key"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/keys/{id}/revocations":{"post":{"summary":"Revoke one of your keys now: reason (3 to 480 characters). A key may revoke itself. The last working admin key cannot be revoked.","tags":["Your keys"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["key"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/media":{"get":{"summary":"List media assets visible to you, in order of their latest change: event_id, media_type (photo, video, audio, document, other), asset_status (pending, stored, unpublished, retracted), authenticity_class, limit, cursor. Lists never carry a download address; read one asset for that.","tags":["Media"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"media":{"type":"array","items":{"type":"object","properties":{"asset_status":{"type":"string"},"authenticity_class":{"type":"string"},"byte_size":{"type":"integer"},"event_id":{"type":"string"},"links":{"type":"object","properties":{"self":{"type":"string"}}},"media_asset_id":{"type":"string"},"media_type":{"type":"string"},"mime_type":{"type":"string"},"original_filename":{"type":"string"},"recorded_at":{"type":"string"},"version_no":{"type":"integer"},"visibility":{"type":"string"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"nullable":true},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/time/tightenings":{"get":{"summary":"The flag list: borrowed time positions whose container changed. flag_status (open, approved, dismissed; default open), limit, cursor. Each flag shows the borrower's current limits, the container's current limits and the limits the borrower would get if approved. Scope review.","tags":["Tightening"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"tightenings":{"type":"array","items":{"type":"object","properties":{"borrower":{"type":"object","properties":{"current_limits":{"type":"object","properties":{"begin_earliest_s":{"type":"string"},"begin_latest_s":{"type":"string"},"end_earliest_s":{"type":"string"},"end_latest_s":{"type":"string"}}},"duration_s":{"type":"string"},"subject_id":{"type":"string"},"subject_kind":{"type":"string"},"temporal_position_id":{"type":"string"},"version_no":{"type":"integer"},"written":{"nullable":true}}},"container":{"type":"object","properties":{"changed_in_row_id":{"type":"integer"},"current_limits":{"type":"object","properties":{"begin_earliest_s":{"type":"string"},"begin_latest_s":{"type":"string"},"end_earliest_s":{"type":"string"},"end_latest_s":{"type":"string"}}},"temporal_position_id":{"type":"string"},"version_no":{"type":"integer"}}},"decided_at":{"nullable":true},"decided_by_actor_id":{"nullable":true},"decision_note":{"nullable":true},"flag_status":{"type":"string"},"flagged_at":{"type":"string"},"links":{"type":"object","properties":{"borrower_versions":{"type":"string"},"decisions":{"type":"string"},"self":{"type":"string"}}},"proposal_error":{"nullable":true},"proposed_limits":{"type":"object","properties":{"begin_earliest_s":{"type":"string"},"begin_latest_s":{"type":"string"},"end_earliest_s":{"type":"string"},"end_latest_s":{"type":"string"}}},"resulting_version_no":{"nullable":true},"time_tightening_flag_id":{"type":"string"},"version_no":{"type":"integer"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"flag_status":{"type":"string"},"limit":{"type":"integer"},"next_cursor":{"nullable":true},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["review"]}]}},"/v1/time/tightenings/{fid}/decisions":{"post":{"summary":"Decide a flag: decision approve or dismiss, note. Approval writes the borrower's new version with limits recomputed from the container as it is now (its written value and duration still narrow them); dismissal leaves the borrower as it is. You cannot approve a tightening of your own record. Scope review.","tags":["Tightening"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["review"]}],"parameters":[{"name":"fid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/entities/{id}/shapes":{"post":{"summary":"Add a shape to your place: shape_kind circle (center_latitude, center_longitude, radius_m more than zero) or polygon / multipolygon (geometry_wkt in well-known text, longitude then latitude, rings closed); valid_written says when the shape was true in the Extended Date/Time Format (1903, 1876-08-01/.., ../1899; omit for always); within_entity_id names the place it sat inside; shape_role (boundary, footprint, approximate, other), boundary_source, source_id, note. The server works out the bounding box, point count and the validity limits. spatial_frame_id defaults to Earth WGS 84.","tags":["Places"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}},"get":{"summary":"The shapes of a place visible to you, without their outlines: each entry says how large the outline is (geometry_bytes) and links to it (links.geometry). at (a written date) keeps only the shapes true at that time; shape_status (active, retracted; default active); limit, cursor.","tags":["Places"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"shapes":{"type":"array","items":{"type":"object","properties":{"bbox_max_lat":{"type":"string"},"bbox_max_lon":{"type":"string"},"bbox_min_lat":{"type":"string"},"bbox_min_lon":{"type":"string"},"boundary_source":{"type":"string"},"center_latitude":{"nullable":true},"center_longitude":{"nullable":true},"change_reason":{"type":"string"},"entity_id":{"type":"string"},"geometry_bytes":{"type":"integer"},"links":{"type":"object","properties":{"geometry":{"type":"string"},"place":{"type":"string"},"self":{"type":"string"},"versions":{"type":"string"},"within":{"type":"string"}}},"note":{"nullable":true},"place_shape_id":{"type":"string"},"point_count":{"type":"integer"},"radius_m":{"nullable":true},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"row_id":{"type":"integer"},"shape_kind":{"type":"string"},"shape_role":{"type":"string"},"shape_status":{"type":"string"},"source_id":{"nullable":true},"spatial_frame_id":{"type":"string"},"supersedes_row_id":{"nullable":true},"valid_from_s":{"type":"string"},"valid_to_s":{"nullable":true},"valid_written":{"type":"string"},"version_no":{"type":"integer"},"within_entity_id":{"type":"string"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"at":{"nullable":true},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"nullable":true},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/shapes/{shid}/versions":{"post":{"summary":"New version of a shape (owner of the place, or a reviewer): any shape field, valid_written, within_entity_id, shape_status retracted; change_reason required.","tags":["Places"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"shid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}}},"/v1/shapes":{"get":{"summary":"Which places contain a point: lat, lon (decimal degrees), optional at (a written date). Candidates come from the bounding box; each is then tested exactly (distance for circles, ray casting for polygons with holes). Answers name the shapes and their places without the outlines (a country outline can be a megabyte); follow links.geometry when you need one.","tags":["Places"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"shapes":{"type":"array","items":{"type":"object","properties":{"bbox_max_lat":{"type":"string"},"bbox_max_lon":{"type":"string"},"bbox_min_lat":{"type":"string"},"bbox_min_lon":{"type":"string"},"boundary_source":{"type":"string"},"center_latitude":{"nullable":true},"center_longitude":{"nullable":true},"change_reason":{"type":"string"},"entity_id":{"type":"string"},"geometry_bytes":{"type":"integer"},"links":{"type":"object","properties":{"geometry":{"type":"string"},"place":{"type":"string"},"self":{"type":"string"},"versions":{"type":"string"},"within":{"type":"string"}}},"note":{"nullable":true},"place_shape_id":{"type":"string"},"point_count":{"type":"integer"},"radius_m":{"nullable":true},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"row_id":{"type":"integer"},"shape_kind":{"type":"string"},"shape_role":{"type":"string"},"shape_status":{"type":"string"},"source_id":{"nullable":true},"spatial_frame_id":{"type":"string"},"supersedes_row_id":{"nullable":true},"valid_from_s":{"type":"string"},"valid_to_s":{"nullable":true},"valid_written":{"type":"string"},"version_no":{"type":"integer"},"within_entity_id":{"type":"string"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"at":{"nullable":true},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"nullable":true},"note":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/shapes/{shid}":{"get":{"summary":"One shape with its full outline (geometry_wkt, well-known text, longitude then latitude), following the visibility of its place.","tags":["Places"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"shape":{"type":"object","properties":{"bbox_max_lat":{"type":"string"},"bbox_max_lon":{"type":"string"},"bbox_min_lat":{"type":"string"},"bbox_min_lon":{"type":"string"},"boundary_source":{"type":"string"},"center_latitude":{"nullable":true},"center_longitude":{"nullable":true},"change_reason":{"type":"string"},"entity_id":{"type":"string"},"geometry_bytes":{"type":"integer"},"geometry_wkt":{"type":"string"},"links":{"type":"object","properties":{"geometry":{"type":"string"},"place":{"type":"string"},"self":{"type":"string"},"versions":{"type":"string"},"within":{"type":"string"}}},"note":{"nullable":true},"place_shape_id":{"type":"string"},"point_count":{"type":"integer"},"radius_m":{"nullable":true},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"row_id":{"type":"integer"},"shape_kind":{"type":"string"},"shape_role":{"type":"string"},"shape_status":{"type":"string"},"source_id":{"nullable":true},"spatial_frame_id":{"type":"string"},"supersedes_row_id":{"nullable":true},"valid_from_s":{"type":"string"},"valid_to_s":{"nullable":true},"valid_written":{"type":"string"},"version_no":{"type":"integer"},"within_entity_id":{"type":"string"}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"shid","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/place/{sid}/universal":{"post":{"summary":"Ask for the universal position of an observed place position (owner of its record, or a reviewer). at_written: the instant, Extended Date/Time Format in Universal Time (default: the start of the record's first time position); horizons_target: a Horizons body or spacecraft number (default: taken from the position's body — Earth 399, Mars 499, Moon 301, Sun 10 and the planets); uncertainty_km (raised to the body radius plus the position's own uncertainty when a body centre is used); note. Answers 202 with the queued row; the lookup runs after this answer and retries up to six times.","tags":["Universal positions"],"responses":{"201":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[{"bearerKey":["submit"]}],"parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields as listed in the summary. Unknown fields are refused."}}}}},"get":{"summary":"The universal positions asked for on an observed position: lookup_status (queued, done, failed), the state vector x_km y_km z_km and vx_km_s vy_km_s vz_km_s on the International Celestial Reference Frame from the solar system barycentre, jd_ut, target_name, ephemeris_source, provider_version, fetched_at, last_error. Reading nudges stale lookups along; readers never wait on NASA. limit, cursor.","tags":["Universal positions"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"universal_positions":{"type":"array","items":{"type":"object","properties":{"at_s":{"type":"string"},"at_written":{"type":"string"},"attempts":{"type":"integer"},"center":{"type":"string"},"change_reason":{"type":"string"},"ephemeris_source":{"type":"string"},"fetched_at":{"type":"string"},"horizons_target":{"type":"string"},"jd_ut":{"type":"string"},"last_error":{"nullable":true},"links":{"type":"object","properties":{"observed":{"type":"string"},"self":{"type":"string"},"subject":{"type":"string"}}},"lookup_status":{"type":"string"},"note":{"nullable":true},"owner_actor_id":{"type":"string"},"provider":{"type":"string"},"provider_version":{"type":"string"},"recorded_at":{"type":"string"},"recorded_by_actor_id":{"type":"string"},"reference_frame":{"type":"string"},"request_url":{"type":"string"},"response_excerpt":{"type":"string"},"row_id":{"type":"integer"},"spatial_position_id":{"type":"string"},"subject_id":{"type":"string"},"subject_kind":{"type":"string"},"supersedes_row_id":{"type":"integer"},"target_name":{"type":"string"},"uncertainty_km":{"type":"string"},"universal_position_id":{"type":"string"},"version_no":{"type":"integer"},"vx_km_s":{"type":"string"},"vy_km_s":{"type":"string"},"vz_km_s":{"type":"string"},"x_km":{"type":"string"},"y_km":{"type":"string"},"z_km":{"type":"string"}}}}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"nullable":true},"request_id":{"type":"string"},"server_time":{"type":"string"},"standard":{"type":"string"}}},"ok":{"type":"boolean"}}}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[],"parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/docs":{"get":{"summary":"This page.","tags":["Documentation"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}},"/v1/docs/openapi":{"get":{"summary":"An OpenAPI 3.0 description of every address, with response schemas derived from the frozen response shapes.","tags":["Documentation"],"responses":{"200":{"description":"Success envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_ok"}}}},"400":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"401":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"403":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"404":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"405":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"409":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"410":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"429":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}},"451":{"description":"Error envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/envelope_error"}}}}},"security":[]}}},"components":{"securitySchemes":{"bearerKey":{"type":"http","scheme":"bearer","description":"Authorization: Bearer ck_live_...  Scopes: submit, review, admin."}},"schemas":{"envelope_ok":{"type":"object","properties":{"data":{"type":"object","properties":{"description":{"type":"string"},"docs":{"type":"string"},"health":{"type":"string"},"name":{"type":"string"}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}},"envelope_error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"type":{"type":"string"}}},"meta":{"type":"object","properties":{"api_version":{"type":"string"},"build":{"type":"string"},"request_id":{"type":"string"},"server_time":{"type":"string"}}},"ok":{"type":"boolean"}}}}}}