{
 "openapi": "3.1.0",
 "info": {
  "title": "Cable Watch: published files",
  "version": "1",
  "description": "Undersea cable damage, sabotage and seabed infrastructure in the Australia–Indo-Pacific, watched daily: a brief, operator status quoted verbatim, hourly route latency and a 30-day evidence index. Cable Watch records observations and provenance; it never concludes attribution. claim_type is what a document claims, not a finding. A latency route is a path between two places, never a named cable.",
  "license": {
   "name": "CC BY 4.0",
   "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "contact": {
   "email": "admin@liminallayers.com"
  }
 },
 "servers": [
  {
   "url": "https://cablewatch.liminallayers.com"
  }
 ],
 "paths": {
  "/data/status.json": {
   "get": {
    "operationId": "get-data-status-json",
    "summary": "Operator status",
    "responses": {
     "200": {
      "description": "Operator incidents and scheduled works on tracked cable systems, quoted verbatim from each operator's own page, with when the page was last checked.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "generated_at": {
           "type": "string"
          },
          "build_id": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "license": {
           "type": "object"
          },
          "provenance_rule": {
           "type": "string"
          },
          "fields": {
           "type": "object"
          },
          "selection": {
           "type": "string"
          },
          "entries": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string",
              "description": "Stable while the entry lasts: source, system and the timeline's first date."
             },
             "system": {
              "type": "string",
              "description": "The tracked cable system the entry concerns, as the operator names it."
             },
             "systemId": {
              "type": "string",
              "description": "data/systems.json id for system, or null."
             },
             "operator": {
              "type": "string",
              "description": "Whose page it is."
             },
             "kind": {
              "type": "string",
              "description": "incident | notice (an undated item on an operator's outage list) | maintenance."
             },
             "status": {
              "type": [
               "null",
               "string"
              ],
              "description": "The operator's own status label, if the page gives one."
             },
             "state": {
              "type": "string",
              "description": "The operator's label bucketed for display: fault (outage, offline, disruption...) | early (identified, investigating, monitoring, an active notice, or a label we do not recognise: never assumed healthy) | scheduled | resolved. Our bucketing of their word, not a finding."
             },
             "title": {
              "type": "string",
              "description": "The operator's own title, or null when the page gives none."
             },
             "quote": {
              "type": "string",
              "description": "The operator's latest words, verbatim and whole."
             },
             "quoteShort": {
              "type": "string",
              "description": "The same cut at a sentence end, for display; ends in \" …\" when cut."
             },
             "sourceUrl": {
              "type": "string",
              "description": "The page it was read from."
             },
             "dateKind": {
              "type": "string",
              "description": "What dateAt is: updated (the operator's timestamp on its latest update) | operatorHeading (an undated notice the operator headed with a time) | firstSeen (no operator date at all: when Cable Watch first saw it) | window (scheduled works: see windowStart)."
             },
             "dateAt": {
              "type": "string",
              "description": "UTC, of the kind dateKind says. null for works."
             },
             "openedAt": {
              "type": [
               "null",
               "string"
              ],
              "description": "UTC of the first update on the operator's timeline. null for a notice and for a partial page."
             },
             "partial": {
              "type": "boolean",
              "description": "The page keeps only some of the incident's updates, so its first update is not when the incident began."
             },
             "firstSeen": {
              "type": "null",
              "description": "Undated notices: when Cable Watch first saw this text. null otherwise."
             },
             "lastCheckedAt": {
              "type": "string",
              "description": "UTC, the last successful poll of the page."
             },
             "windowStart": {
              "type": "null",
              "description": "Scheduled works: start as the operator gave it. null otherwise."
             },
             "windowEnd": {
              "type": "null",
              "description": "Scheduled works: end. null otherwise."
             },
             "repairWindowStart": {
              "type": "null",
              "description": "An incident's or notice's repair window, read from explicit start/end wording in quote (a date, or a UTC time when the operator gave one). quote stays the authority. null if none."
             },
             "repairWindowEnd": {
              "type": "null",
              "description": "Its end."
             }
            }
           }
          },
          "sources_fields": {
           "type": "object"
          },
          "sources": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string",
              "description": "Cable Watch's id for the page."
             },
             "name": {
              "type": "string",
              "description": "The page."
             },
             "url": {
              "type": "string",
              "description": "Where it is."
             },
             "lastCheckedAt": {
              "type": "string",
              "description": "UTC, the last successful poll; null if none in the last day."
             },
             "hasParser": {
              "type": "boolean",
              "description": "Whether Cable Watch reads incidents off this page. When false, it is polled for changes and nothing is said about its state."
             },
             "systemsWithIncident": {
              "type": "array",
              "description": "Tracked systems an open entry on this page names."
             }
            }
           }
          },
          "untrackedOpen": {
           "type": "integer"
          },
          "untrackedOpen_note": {
           "type": "string"
          }
         }
        }
       }
      }
     }
    },
    "description": "Operator incidents and scheduled works on tracked cable systems, quoted verbatim from each operator's own page, with when the page was last checked."
   }
  },
  "/data/latency.json": {
   "get": {
    "operationId": "get-data-latency-json",
    "summary": "Route latency",
    "responses": {
     "200": {
      "description": "Per route between two places: best path per hour, its sustained baseline, and how many direct paths it has now against normally. Measured hourly, published once a day. A route is not a cable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "generated_at": {
           "type": "string"
          },
          "build_id": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "license": {
           "type": "object"
          },
          "provenance_rule": {
           "type": "string"
          },
          "fields": {
           "type": "object"
          },
          "caveat": {
           "type": "string"
          },
          "routes": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string",
              "description": "Route id. Join to data/events.json route_id and data/systems.json routes."
             },
             "label": {
              "type": "string",
              "description": "The route's name: a pair of places, never a cable."
             },
             "from": {
              "type": "string",
              "description": "Near end."
             },
             "to": {
              "type": "string",
              "description": "Far end."
             },
             "series": {
              "type": "array",
              "description": "Best path (ms) per hour for the last 24 hours, oldest first: the lowest round-trip time across every measured path in that hour. null where the hour had no reading (never filled in). Hours before the route's first reading are left out, so read seriesStartHour for the first value's hour."
             },
             "seriesStartHour": {
              "type": "string",
              "description": "UTC start of the hour the first value of series describes."
             },
             "series7d": {
              "type": "array",
              "description": "The same, hourly, for 7 days."
             },
             "series7dStartHour": {
              "type": "string",
              "description": "UTC start of the hour the first value of series7d describes."
             },
             "seriesLastHour": {
              "type": "string",
              "description": "UTC start of the hour the last value of both series describes."
             },
             "floorMs": {
              "type": "number",
              "description": "PHYSICAL floor (ms): great-circle round trip at the speed of light in fibre. The only thing called a floor anywhere on this site."
             },
             "baselineMs": {
              "type": "number",
              "description": "The route's baseline: lowest sustained best path over 30 days (third-lowest daily value). null when there is not enough history."
             },
             "state": {
              "type": "string",
              "description": "The best path's state only: steady | spiky (congested, intact) | stepped (the best path is above its baseline: the shortest way is longer) | no-baseline. It does not see most paths moving while the best holds: read activeEvents with it."
             },
             "deltaMs": {
              "type": "number",
              "description": "Latest best path minus baseline. null with no baseline."
             },
             "variationMs": {
              "type": "number",
              "description": "Range of the 24-hour series."
             },
             "probes": {
              "type": "integer",
              "description": "Most measured paths in any hour of the window."
             },
             "direct": {
              "type": "boolean",
              "description": "Whether the route is judged on direct paths at all."
             },
             "directNow": {
              "type": [
               "integer",
               "null"
              ],
              "description": "Paths in the latest hour within 1.6x of the physical floor. null when the route is not judged on direct paths."
             },
             "directNormal": {
              "type": [
               "integer",
               "null"
              ],
              "description": "Direct paths the route holds when healthy (best sustained count over 30 days, third-highest day): the brief's \"normally N\". null when not judged on direct paths."
             },
             "activeEvents": {
              "type": "array",
              "description": "Detector event types this route is currently reported as being in (see data/events.json; empty when none). The same table the brief's Measured route lines and the alerts read. null if unreadable."
             },
             "lowCoverage": {
              "type": "boolean",
              "description": "Two or fewer paths, or not judged on direct paths: a step here is thin evidence. A coverage fact, not a confidence score."
             },
             "servedBy": {
              "type": "array",
              "description": "Systems the public registry lists for the route. Context only: nothing here can tell which one carries a packet."
             },
             "servedByIds": {
              "type": "array",
              "description": "data/systems.json ids for servedBy, in the same order (null where the registry does not place a name)."
             },
             "soleSystem": {
              "type": "boolean",
              "description": "The registry lists exactly one system for this route."
             }
            }
           }
          }
         }
        }
       }
      }
     }
    },
    "description": "Per route between two places: best path per hour, its sustained baseline, and how many direct paths it has now against normally. Measured hourly, published once a day. A route is not a cable."
   }
  },
  "/data/events.json": {
   "get": {
    "operationId": "get-data-events-json",
    "summary": "Route events",
    "responses": {
     "200": {
      "description": "The hourly route detector's events (a route losing its direct paths, a step in its floor), as episodes with a start and an end.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "generated_at": {
           "type": "string"
          },
          "build_id": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "license": {
           "type": "object"
          },
          "provenance_rule": {
           "type": "string"
          },
          "fields": {
           "type": "object"
          },
          "event_types": {
           "type": "object"
          },
          "window_days": {
           "type": "integer"
          },
          "count": {
           "type": "integer"
          },
          "events": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string",
              "description": "Stable: route, type and start."
             },
             "route_id": {
              "type": "string",
              "description": "data/latency.json route id."
             },
             "route": {
              "type": "string",
              "description": "The route's name. A pair of places, never a cable."
             },
             "type": {
              "type": "string",
              "description": "See event_types."
             },
             "start": {
              "type": "string",
              "description": "UTC hour the condition was first reported."
             },
             "end": {
              "type": [
               "null",
               "string"
              ],
              "description": "UTC hour it was reported cleared (two consecutive clear hours, judged at a lower bar than it was raised at), or null while it holds."
             },
             "readings": {
              "type": "integer",
              "description": "How many times the detector reported it inside this episode. 1 is normal; more means it was raised, cleared and raised again within two hours."
             },
             "vantages": {
              "type": "integer",
              "description": "Independent source networks that agreed (most in any reading)."
             },
             "single_vantage": {
              "type": "boolean",
              "description": "Raised on one vantage held for two hours, where no second exists."
             },
             "paths_total": {
              "type": "integer",
              "description": "Paths measured in the hour it was raised."
             },
             "paths_moved": {
              "type": "integer",
              "description": "Of those, how many moved (stepped, or were lost)."
             },
             "direct_before": {
              "type": [
               "integer",
               "null"
              ],
              "description": "DIRECT_LOST only: direct paths the route normally holds."
             },
             "direct_after": {
              "type": [
               "integer",
               "null"
              ],
              "description": "DIRECT_LOST only: direct paths left."
             },
             "from_ms": {
              "type": "number",
              "description": "Best (DIRECT_LOST) or median moved path's floor before, ms. Null if not given."
             },
             "to_ms": {
              "type": "number",
              "description": "The same, after."
             },
             "sole_system_id": {
              "type": [
               "null",
               "string"
              ],
              "description": "Set when the registry lists exactly one system for the route (data/systems.json id). A registry fact, not an inference."
             },
             "detail": {
              "type": "string",
              "description": "The detector's own sentence."
             }
            }
           }
          }
         }
        }
       }
      }
     }
    },
    "description": "The hourly route detector's events (a route losing its direct paths, a step in its floor), as episodes with a start and an end."
   }
  },
  "/data/systems.json": {
   "get": {
    "operationId": "get-data-systems-json",
    "summary": "Cable systems",
    "responses": {
     "200": {
      "description": "Every cable system a Cable Watch file names, keyed on TeleGeography's own id, with its aliases, routes, status sources and open incidents.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "generated_at": {
           "type": "string"
          },
          "build_id": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "license": {
           "type": "object"
          },
          "provenance_rule": {
           "type": "string"
          },
          "fields": {
           "type": "object"
          },
          "count": {
           "type": "integer"
          },
          "systems": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string",
              "description": "TeleGeography's own id for the system (submarinecablemap.com/submarine-cable/{id}). Null when its registry does not place the name; nothing here makes one up."
             },
             "name": {
              "type": "string",
              "description": "The registry's name for it."
             },
             "aliases": {
              "type": "array",
              "description": "Every other spelling a Cable Watch file uses for it. Join on id, not on these."
             },
             "routes": {
              "type": "array",
              "description": "Measured routes the registry says it serves (data/latency.json ids). Context only: a route is a pair of places, not this cable."
             },
             "status_sources": {
              "type": "array",
              "description": "Operator pages read for incidents on it that currently name it."
             },
             "open_incidents": {
              "type": "array",
              "description": "data/status.json entry ids naming it."
             },
             "threads": {
              "type": "array",
              "description": "Incident threads in the brief (\"Incident threads\") that concern it."
             }
            }
           }
          }
         }
        }
       }
      }
     }
    },
    "description": "Every cable system a Cable Watch file names, keyed on TeleGeography's own id, with its aliases, routes, status sources and open incidents."
   }
  },
  "/data/corridors.json": {
   "get": {
    "operationId": "get-data-corridors-json",
    "summary": "RIPE Atlas corridors",
    "responses": {
     "200": {
      "description": "RIPE Atlas traceroute corridors over 24 hours: city pairs measured between anchors. A different product from the hourly routes, and the two may disagree on one city pair.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "generated_at": {
           "type": "string"
          },
          "build_id": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "license": {
           "type": "object"
          },
          "provenance_rule": {
           "type": "string"
          },
          "fields": {
           "type": "object"
          },
          "caveat": {
           "type": "string"
          },
          "window_hours": {
           "type": "integer"
          },
          "count": {
           "type": "integer"
          },
          "corridors": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string",
              "description": "Corridor id. A different product from data/latency.json's routes: traceroute between a few fixed RIPE Atlas anchors, read over 24 hours."
             },
             "corridor": {
              "type": "string",
              "description": "A city pair, never a cable."
             },
             "best_ms": {
              "type": "number",
              "description": "Shortest path any probe on the corridor had over 24 hours."
             },
             "best_baseline_ms": {
              "type": "number",
              "description": "The corridor's baseline: the shortest path it has sustained (third-best day) over baseline_days. Not a physical floor."
             },
             "best_step_ms": {
              "type": "number",
              "description": "best_ms minus best_baseline_ms."
             },
             "typical_ms": {
              "type": "number",
              "description": "Median across probes. Describes the middle of unrelated paths, so it moves when the probe sample changes; read paired_step_ms instead."
             },
             "paired_step_ms": {
              "type": "number",
              "description": "Median of each probe's shift against its own history."
             },
             "paired_probes": {
              "type": "integer",
              "description": "Probes present in both windows."
             },
             "crossing_ms": {
              "type": "number",
              "description": "Median ocean crossing: the RTT between the last hop on the near side and the first on the far side, found from the physical floor."
             },
             "queuing_ms": {
              "type": "number",
              "description": "Crossing median minus crossing minimum: congestion with distance removed."
             },
             "gap_hops": {
              "type": "number",
              "description": "0 = a clean single-link crossing; above 0, responding hops sat between the boundaries and the crossing includes them."
             },
             "probes": {
              "type": "integer",
              "description": "Probes with a plausible reading."
             },
             "excluded_readings": {
              "type": "integer",
              "description": "Readings dropped as faster than light allows over that distance."
             },
             "baseline_days": {
              "type": "number",
              "description": "Days of history the baseline is taken over; null when under 7."
             }
            }
           }
          }
         }
        }
       }
      }
     }
    },
    "description": "RIPE Atlas traceroute corridors over 24 hours: city pairs measured between anchors. A different product from the hourly routes, and the two may disagree on one city pair."
   }
  },
  "/data/coverage.json": {
   "get": {
    "operationId": "get-data-coverage-json",
    "summary": "Measurement coverage",
    "responses": {
     "200": {
      "description": "What the route measurement cannot see, and why: systems with no usable vantage.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "generated_at": {
           "type": "string"
          },
          "build_id": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "license": {
           "type": "object"
          },
          "provenance_rule": {
           "type": "string"
          },
          "fields": {
           "type": "object"
          },
          "note": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "uncovered": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "system": {
              "type": "string",
              "description": "The system or branch with no usable vantage."
             },
             "reason": {
              "type": "string",
              "description": "Why nothing can be measured there."
             }
            }
           }
          }
         }
        }
       }
      }
     }
    },
    "description": "What the route measurement cannot see, and why: systems with no usable vantage."
   }
  },
  "/data/evidence.json": {
   "get": {
    "operationId": "get-data-evidence-json",
    "summary": "Evidence index (30 days)",
    "responses": {
     "200": {
      "description": "Relevant documents from the last 30 days: link, archive copy, claim_type, cables and vessels named, jurisdictions, classifier summary. No article text.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "generated_at": {
           "type": "string"
          },
          "build_id": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "license": {
           "type": "object"
          },
          "provenance_rule": {
           "type": "string"
          },
          "fields": {
           "type": "object"
          },
          "claim_types": {
           "type": "object"
          },
          "publisher_classes": {
           "type": "object"
          },
          "summary_note": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "documents": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string",
              "description": "The document's own headline."
             },
             "url": {
              "type": "string",
              "description": "Where it was read. The source is the authority; follow it for the words."
             },
             "wayback_url": {
              "type": [
               "null",
               "string"
              ],
              "description": "An Internet Archive copy, or null when none exists yet."
             },
             "source_id": {
              "type": "string",
              "description": "Which of Cable Watch's sources found it (search discovery is searxng_discovery)."
             },
             "publisher_host": {
              "type": "string",
              "description": "The host the URL is on."
             },
             "publisher_class": {
              "type": "string",
              "description": "self-published | republisher | unlisted (see publisher_classes). Says what the HOST is; claim_type says what the DOCUMENT claims. A Substack post can be analyst_assessment and self-published at once: an assessment, by one writer of unknown standing."
             },
             "published_at": {
              "type": [
               "null",
               "string"
              ],
              "description": "UTC, as the publisher dated it; null for undated operator and registry pages."
             },
             "fetched_at": {
              "type": "string",
              "description": "UTC, when Cable Watch read it."
             },
             "claim_type": {
              "type": "string",
              "description": "What the document claims (see claim_types). Never a finding of ours."
             },
             "summary": {
              "type": "string",
              "description": "Two sentences by our classifier. A model's reading, not the source's words."
             },
             "cables": {
              "type": "array",
              "description": "Cable systems the document names, as written in it."
             },
             "vessels": {
              "type": "array",
              "description": "Vessels named or identified by IMO number in it. Named is not implicated."
             },
             "jurisdictions": {
              "type": "array",
              "description": "ISO 3166-1 alpha-2 codes the document concerns, plus EU (the European Union) and INT (international, no one country)."
             },
             "categories": {
              "type": "array",
              "description": "fault | investigation | vessel_activity | policy | repair | analysis | precedent | seabed_security: what the document is about, not what happened."
             },
             "region_priority": {
              "type": "string",
              "description": "core (Australia, New Zealand, the Pacific islands) | regional (the wider Indo-Pacific) | global | unknown, from jurisdictions by lookup table."
             },
             "doc_kind": {
              "type": "string",
              "description": "article | status_page (an operator's own page, captured whole)."
             },
             "source_category": {
              "type": "string",
              "description": "The kind of source: news_general, cable_trade, operator_status, government_au, analysis_thinktank and so on."
             },
             "classifier_version": {
              "type": "string",
              "description": "Model and prompt version that judged it, so verdicts stay comparable."
             },
             "cable_ids": {
              "type": "array",
              "description": "data/systems.json ids for cables, in the same order; null where the registry does not place a name (descriptions like \"Batanes cable corridor\" never resolve)."
             }
            }
           }
          }
         }
        }
       }
      }
     }
    },
    "description": "Relevant documents from the last 30 days: link, archive copy, claim_type, cables and vessels named, jurisdictions, classifier summary. No article text."
   }
  },
  "/data/evidence.jsonl": {
   "get": {
    "operationId": "get-data-evidence-jsonl",
    "summary": "Evidence index (30 days), JSON Lines",
    "responses": {
     "200": {
      "description": "The evidence index as one JSON object per line, the same records as /data/evidence.json.",
      "content": {
       "application/jsonl": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    },
    "description": "The evidence index as one JSON object per line, the same records as /data/evidence.json."
   }
  },
  "/briefs/index.json": {
   "get": {
    "operationId": "get-briefs-index-json",
    "summary": "Every edition",
    "responses": {
     "200": {
      "description": "Every daily edition, newest first, with links to its page, its markdown and, where it has a podcast, its transcript and mp3; and every gap in the run of dates.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "generated_at": {
           "type": "string"
          },
          "build_id": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "license": {
           "type": "object"
          },
          "provenance_rule": {
           "type": "string"
          },
          "fields": {
           "type": "object"
          },
          "issue_note": {
           "type": "string"
          },
          "gaps": {
           "type": "array"
          },
          "editions": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "date": {
              "type": "string",
              "description": "The edition's date (UTC). One edition a day at most."
             },
             "issue": {
              "type": "integer",
              "description": "Days since 2026-07-25, plus one: the date as a number, so a missed day leaves a gap in the numbers and len(editions) is not the newest issue."
             },
             "title": {
              "type": "string",
              "description": "The lead story's headline, as the model wrote it from the lead source."
             },
             "standfirst": {
              "type": "string",
              "description": "Two sentences under the title, model-written."
             },
             "jurisdictions": {
              "type": "array",
              "description": "ISO 3166-1 alpha-2 codes (plus EU and INT) of the edition's most prominent stories, at most six."
             },
             "page": {
              "type": "string",
              "description": "The edition as a static HTML page."
             },
             "markdown": {
              "type": "string",
              "description": "The edition exactly as filed. Cite this, not latest.md."
             },
             "transcript": {
              "type": [
               "null",
               "string"
              ],
              "description": "What the podcast said, or null when there is no episode."
             },
             "audio": {
              "type": [
               "null",
               "string"
              ],
              "description": "The episode's mp3, or null: episodes start 2026-09-13, and a day with nothing to tell has none."
             },
             "audio_bytes": {
              "type": [
               "integer",
               "null"
              ],
              "description": "Size of the mp3."
             },
             "audio_seconds": {
              "type": [
               "integer",
               "null"
              ],
              "description": "Length of the mp3."
             },
             "published_at": {
              "type": "string",
              "description": "When it came out: when it was written, or 20:00 UTC on its date when it was written on a later day."
             },
             "written_at": {
              "type": "string",
              "description": "When the file was last written."
             },
             "backfilled": {
              "type": "boolean",
              "description": "Written on a later day than its date (a replay or catch-up)."
             }
            }
           }
          }
         }
        }
       }
      }
     }
    },
    "description": "Every daily edition, newest first, with links to its page, its markdown and, where it has a podcast, its transcript and mp3; and every gap in the run of dates."
   }
  },
  "/briefs/latest.json": {
   "get": {
    "operationId": "get-briefs-latest-json",
    "summary": "Newest edition (metadata)",
    "responses": {
     "200": {
      "description": "The newest edition with a podcast. It moves every day: cite canonical_url.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "generated_at": {
           "type": "string"
          },
          "build_id": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "license": {
           "type": "object"
          },
          "provenance_rule": {
           "type": "string"
          },
          "fields": {
           "type": "object"
          },
          "canonical_url": {
           "type": "string",
           "description": "The dated markdown file to cite: latest.md moves every day."
          },
          "date": {
           "type": "string",
           "description": "The edition's date (UTC). One edition a day at most."
          },
          "issue": {
           "type": "integer",
           "description": "Days since 2026-07-25, plus one: the date as a number, so a missed day leaves a gap in the numbers and len(editions) is not the newest issue."
          },
          "title": {
           "type": "string",
           "description": "The lead story's headline, as the model wrote it from the lead source."
          },
          "standfirst": {
           "type": "string",
           "description": "Two sentences under the title, model-written."
          },
          "jurisdictions": {
           "type": "array",
           "description": "ISO 3166-1 alpha-2 codes (plus EU and INT) of the edition's most prominent stories, at most six."
          },
          "page": {
           "type": "string",
           "description": "The edition as a static HTML page."
          },
          "markdown": {
           "type": "string",
           "description": "The edition exactly as filed. Cite this, not latest.md."
          },
          "transcript": {
           "type": "string",
           "description": "What the podcast said, or null when there is no episode."
          },
          "audio": {
           "type": "string",
           "description": "The episode's mp3, or null: episodes start 2026-09-13, and a day with nothing to tell has none."
          },
          "audio_bytes": {
           "type": "integer",
           "description": "Size of the mp3."
          },
          "audio_seconds": {
           "type": "integer",
           "description": "Length of the mp3."
          },
          "published_at": {
           "type": "string",
           "description": "When it came out: when it was written, or 20:00 UTC on its date when it was written on a later day."
          },
          "written_at": {
           "type": "string",
           "description": "When the file was last written."
          },
          "backfilled": {
           "type": "boolean",
           "description": "Written on a later day than its date (a replay or catch-up)."
          }
         }
        }
       }
      }
     }
    },
    "description": "The newest edition with a podcast. It moves every day: cite canonical_url."
   }
  },
  "/briefs/latest.md": {
   "get": {
    "operationId": "get-briefs-latest-md",
    "summary": "Newest brief",
    "responses": {
     "200": {
      "description": "The newest edition with a podcast, as filed. It moves every day: cite /briefs/{date}.md.",
      "content": {
       "text/markdown": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    },
    "description": "The newest edition with a podcast, as filed. It moves every day: cite /briefs/{date}.md."
   }
  },
  "/briefs/{date}.md": {
   "get": {
    "operationId": "get-briefs-date-md",
    "summary": "One edition",
    "responses": {
     "200": {
      "description": "An edition exactly as filed, frontmatter included. Dates are in /briefs/index.json.",
      "content": {
       "text/markdown": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    },
    "description": "An edition exactly as filed, frontmatter included. Dates are in /briefs/index.json.",
    "parameters": [
     {
      "name": "date",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ]
   }
  },
  "/newsletter.xml": {
   "get": {
    "operationId": "get-newsletter-xml",
    "summary": "Cable Watch (newsletter feed)",
    "responses": {
     "200": {
      "description": "RSS 2.0, the newest 30 editions in full (content:encoded). Also at /feed.xml.",
      "content": {
       "application/rss+xml": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    },
    "description": "RSS 2.0, the newest 30 editions in full (content:encoded). Also at /feed.xml."
   }
  },
  "/podcast.xml": {
   "get": {
    "operationId": "get-podcast-xml",
    "summary": "Cable Watch (podcast feed)",
    "responses": {
     "200": {
      "description": "The podcast: RSS 2.0 with iTunes and Podcasting 2.0 tags, mp3 enclosures and transcripts.",
      "content": {
       "application/rss+xml": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    },
    "description": "The podcast: RSS 2.0 with iTunes and Podcasting 2.0 tags, mp3 enclosures and transcripts."
   }
  }
 }
}
