{
  "openapi": "3.1.0",
  "info": {
    "title": "Alethman API",
    "version": "1.0.0",
    "summary": "Read Alethman's narrative intelligence for your workspace: articles, stories, sector outlooks, forecasts, coordination findings, reports and your own sources.",
    "description": "Every endpoint reads through the workspace the key belongs to. Authenticate with `Authorization: Bearer alm_live_…`. 120 requests a minute per key.",
    "contact": {
      "name": "Alethman",
      "url": "https://alethman.com/contact/"
    }
  },
  "servers": [
    {
      "url": "https://dash.alethman.com/api/v1"
    }
  ],
  "security": [
    {
      "bearer": []
    }
  ],
  "tags": [
    {
      "name": "Workspace",
      "description": "The key's workspace and scope."
    },
    {
      "name": "Signals",
      "description": "Articles."
    },
    {
      "name": "Stories",
      "description": "Events, grouped."
    },
    {
      "name": "Outlooks",
      "description": "Sector readings."
    },
    {
      "name": "Forecasts",
      "description": "Dated forecasts and their record."
    },
    {
      "name": "Coordination",
      "description": "Coordination findings."
    },
    {
      "name": "Reports",
      "description": "Compiled reports."
    },
    {
      "name": "Sources",
      "description": "The workspace's own feeds."
    }
  ],
  "paths": {
    "/workspace": {
      "get": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "getWorkspace",
        "summary": "Get the workspace",
        "tags": [
          "Workspace"
        ],
        "x-scope": null,
        "x-mcp-tool": "get_workspace",
        "x-page": "workspace",
        "description": "The workspace the key belongs to: what it follows, which parts of Alethman are on, its report and alert settings, and the key's own name and scopes. Any valid key can call it, whatever its scopes. Call it first: every other endpoint reads through the scope it returns.",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Workspace"
                },
                "example": {
                  "workspace": {
                    "name": "Risk desk",
                    "slug": "risk-desk"
                  },
                  "scope": {
                    "sectors": [
                      "energy_power",
                      "politics_governance",
                      "public_order_unrest"
                    ],
                    "states": [],
                    "all_india": true,
                    "national": true
                  },
                  "coverage": [
                    "signals",
                    "live",
                    "stories",
                    "outlooks",
                    "forecasts",
                    "coordination"
                  ],
                  "reports": {
                    "frequency": "weekly",
                    "depth": "dossier",
                    "organise": "sector",
                    "sections": [
                      "judgements",
                      "outlooks",
                      "stories",
                      "states",
                      "forecasts",
                      "coordination",
                      "sources"
                    ],
                    "screenshots": false,
                    "next_at": "2026-11-23T03:30:00.000Z"
                  },
                  "alerts": {
                    "threshold": 40,
                    "kinds": [
                      "threshold",
                      "rising",
                      "coordination",
                      "forecast",
                      "report",
                      "source"
                    ]
                  },
                  "key": {
                    "name": "Analyst notebook",
                    "scopes": [
                      "signals:read",
                      "intel:read",
                      "reports:read",
                      "sources:read"
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/signals": {
      "get": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "listSignals",
        "summary": "List articles",
        "tags": [
          "Signals"
        ],
        "x-scope": "signals:read",
        "x-mcp-tool": "list_signals",
        "x-page": "signals",
        "x-paginated": true,
        "description": "Articles in the workspace's scope, newest first, each with its outlet, sectors, states and the story it was grouped into. The firehose under every other endpoint: use it to mirror coverage into your own store, or to watch a state or sector article by article. Pages with `next_cursor`.",
        "parameters": [
          {
            "name": "sector",
            "in": "query",
            "required": false,
            "description": "Only this sector. It must be one the workspace follows; another sector returns an empty list, not an error.",
            "schema": {
              "type": "string",
              "enum": [
                "textiles_apparel",
                "metals_mining",
                "trade_imports_exports",
                "agriculture_food",
                "energy_power",
                "infrastructure_transport",
                "manufacturing_industry",
                "it_telecom_tech",
                "pharma_health",
                "banking_finance_markets",
                "real_estate_construction",
                "public_order_unrest",
                "insurgency_terrorism",
                "crime_law_enforcement",
                "defence_borders_foreign",
                "politics_governance",
                "environment_disaster",
                "labour_employment_education",
                "media_information"
              ],
              "description": "A sector key. See Countries and scopes for the list."
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "description": "Only this state or union territory.",
            "schema": {
              "type": "string",
              "enum": [
                "andhra-pradesh",
                "arunachal-pradesh",
                "assam",
                "bihar",
                "chhattisgarh",
                "goa",
                "gujarat",
                "haryana",
                "himachal-pradesh",
                "jharkhand",
                "karnataka",
                "kerala",
                "madhya-pradesh",
                "maharashtra",
                "manipur",
                "meghalaya",
                "mizoram",
                "nagaland",
                "odisha",
                "punjab",
                "rajasthan",
                "sikkim",
                "tamil-nadu",
                "telangana",
                "tripura",
                "uttar-pradesh",
                "uttarakhand",
                "west-bengal",
                "andaman-and-nicobar-islands",
                "chandigarh",
                "dadra-and-nagar-haveli-and-daman-and-diu",
                "delhi",
                "jammu-and-kashmir",
                "ladakh",
                "lakshadweep",
                "puducherry"
              ],
              "description": "A state or union territory slug."
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Words to find in the headline.",
            "schema": {
              "type": "string",
              "maxLength": 120
            }
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "description": "Only headlines in this language: an ISO 639-1 code such as `en`, `hi`, `ta`.",
            "schema": {
              "type": "string",
              "maxLength": 8
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only articles published after this time, as ISO 8601, e.g. `2026-11-21T00:00:00Z`.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many articles to return, 1 to 200.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "The `next_cursor` from the previous page. Opaque: pass it back unchanged.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Signal"
                      },
                      "description": "Articles, newest first."
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Pass as `cursor` for the next page. Null when this page is the last (it returned fewer than `limit`)."
                    }
                  },
                  "required": [
                    "data",
                    "next_cursor"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "id": 138695177,
                      "title": "Jammu Kashmir High Court Quashes Withdrawal of NOC for Four Tourist Huts in Pahalgam",
                      "url": "https://kashmirlife.net/jammu-kashmir-high-court-quashes-withdrawal-of-noc-for-four-tourist-huts-in-pahalgam-462123/",
                      "published_at": "2026-11-21T05:01:37.000Z",
                      "language": null,
                      "outlet": {
                        "id": "kashmir-life",
                        "name": "Kashmir Life"
                      },
                      "sectors": [
                        "politics_governance"
                      ],
                      "states": [],
                      "story": null
                    },
                    {
                      "id": 138694799,
                      "title": "Polling Underway Across Ladakh For Panchayat And Municipal Elections 2026",
                      "url": "https://www.dailyexcelsior.com/polling-underway-across-ladakh-for-panchayat-and-municipal-elections-2026/",
                      "published_at": "2026-11-21T05:01:23.000Z",
                      "language": null,
                      "outlet": {
                        "id": "daily-excelsior",
                        "name": "Daily Excelsior"
                      },
                      "sectors": [
                        "politics_governance"
                      ],
                      "states": [],
                      "story": null
                    },
                    {
                      "id": 138682757,
                      "title": "सागर में बिजली कंपनी के स्टोर रूम में भीषण आग:10 फीट ऊंची उठीं लपटें, मीटर-उपकरण जलकर राख; 2 घंटे बाद पाया काबू",
                      "url": "https://www.bhaskar.com/local/mp/sagar/news/makronia-sagar-electricity-company-store-room-fire-incident-139753300.html",
                      "published_at": "2026-11-21T04:58:11.000Z",
                      "language": "hi",
                      "outlet": {
                        "id": "dainik-bhaskar",
                        "name": "Dainik Bhaskar"
                      },
                      "sectors": [
                        "energy_power"
                      ],
                      "states": [],
                      "story": null
                    },
                    {
                      "id": 138626948,
                      "title": "Ladakh votes in panchayat and municipal polls amid bitter chill after eight-year gap",
                      "url": "https://www.greaterkashmir.com/ladakh/ladakh-votes-in-panchayat-and-municipal-polls-amid-bitter-chill-after-eight-year-gap-12828341",
                      "published_at": "2026-11-21T04:46:26.000Z",
                      "language": "en",
                      "outlet": {
                        "id": "greater-kashmir",
                        "name": "Greater Kashmir"
                      },
                      "sectors": [
                        "politics_governance"
                      ],
                      "states": [
                        "ladakh"
                      ],
                      "story": {
                        "id": 294998,
                        "label": "Ladakh Elections 2026: 541 candidates file their nomination papers for 100 LAHDC seats in eight districts",
                        "independent_outlets": 9
                      }
                    }
                  ],
                  "next_cursor": "MjAyNi0xMS0yMVQwNDo0NjoyNi4wMDBafDEzODYyNjk0OA"
                }
              }
            }
          },
          "400": {
            "description": "bad_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "message": "limit must be a whole number from 1 to 200."
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/stories": {
      "get": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "listStories",
        "summary": "List stories",
        "tags": [
          "Stories"
        ],
        "x-scope": "intel:read",
        "x-mcp-tool": "list_stories",
        "x-page": "stories",
        "description": "Stories in scope: articles about one event, grouped, with how many independent outlets carry each, where it is, its risk and a one-line reading. The unit most work starts from.",
        "parameters": [
          {
            "name": "sector",
            "in": "query",
            "required": false,
            "description": "Only this sector. It must be one the workspace follows; another sector returns an empty list, not an error.",
            "schema": {
              "type": "string",
              "enum": [
                "textiles_apparel",
                "metals_mining",
                "trade_imports_exports",
                "agriculture_food",
                "energy_power",
                "infrastructure_transport",
                "manufacturing_industry",
                "it_telecom_tech",
                "pharma_health",
                "banking_finance_markets",
                "real_estate_construction",
                "public_order_unrest",
                "insurgency_terrorism",
                "crime_law_enforcement",
                "defence_borders_foreign",
                "politics_governance",
                "environment_disaster",
                "labour_employment_education",
                "media_information"
              ],
              "description": "A sector key. See Countries and scopes for the list."
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "description": "Only this state or union territory.",
            "schema": {
              "type": "string",
              "enum": [
                "andhra-pradesh",
                "arunachal-pradesh",
                "assam",
                "bihar",
                "chhattisgarh",
                "goa",
                "gujarat",
                "haryana",
                "himachal-pradesh",
                "jharkhand",
                "karnataka",
                "kerala",
                "madhya-pradesh",
                "maharashtra",
                "manipur",
                "meghalaya",
                "mizoram",
                "nagaland",
                "odisha",
                "punjab",
                "rajasthan",
                "sikkim",
                "tamil-nadu",
                "telangana",
                "tripura",
                "uttar-pradesh",
                "uttarakhand",
                "west-bengal",
                "andaman-and-nicobar-islands",
                "chandigarh",
                "dadra-and-nagar-haveli-and-daman-and-diu",
                "delhi",
                "jammu-and-kashmir",
                "ladakh",
                "lakshadweep",
                "puducherry"
              ],
              "description": "A state or union territory slug."
            }
          },
          {
            "name": "hours",
            "in": "query",
            "required": false,
            "description": "How far back to look, in hours, 1 to 720 (30 days). A story counts when its latest article falls inside the window.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 720,
              "default": 72
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "`voices`: most independent outlets first. `risk`: highest risk first. `recent`: newest activity first.",
            "schema": {
              "type": "string",
              "enum": [
                "voices",
                "risk",
                "recent"
              ],
              "default": "voices"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many stories to return, 1 to 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Story"
                      },
                      "description": "Stories in the order asked for."
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "id": 301791,
                      "label": "Manipur Spurious Liquor Tragedy: Death Toll Rises To 11, Over 180 Hospitalised",
                      "independent_outlets": 24,
                      "articles": 41,
                      "trajectory": "steady",
                      "first_seen": "2026-11-19T13:45:01.000Z",
                      "last_seen": "2026-11-21T04:27:58.000Z",
                      "sectors": [
                        "public_order_unrest",
                        "agriculture_food"
                      ],
                      "states": [
                        "manipur"
                      ],
                      "place": "Chandel",
                      "risk_score": 72,
                      "risk_level": "high",
                      "reading": "Suspected methanol-laced local liquor in Chandel district, Manipur, has killed at least 11 to 15 people and hospitalised more than 150.",
                      "event_type": "disaster_accident"
                    },
                    {
                      "id": 297641,
                      "label": "EPFO approves systematic PF withdrawal plan",
                      "independent_outlets": 35,
                      "articles": 89,
                      "trajectory": "steady",
                      "first_seen": "2026-11-18T22:24:07.000Z",
                      "last_seen": "2026-11-21T03:51:15.000Z",
                      "sectors": [
                        "banking_finance_markets",
                        "politics_governance"
                      ],
                      "states": [
                        "delhi"
                      ],
                      "place": "Delhi",
                      "risk_score": 12,
                      "risk_level": "low",
                      "reading": "The EPFO board approved reforms easing PF withdrawals, including a systematic withdrawal plan, lower minimum balance and limited alternative fund investment.",
                      "event_type": "policy_decision"
                    },
                    {
                      "id": 302282,
                      "label": "Supreme Court dismisses Tamil Nadu pleas seeking 11 TMC of Cauvery water from Karnataka",
                      "independent_outlets": 29,
                      "articles": 42,
                      "trajectory": "steady",
                      "first_seen": "2026-11-19T19:23:01.000Z",
                      "last_seen": "2026-11-21T01:27:48.000Z",
                      "sectors": [
                        "agriculture_food",
                        "public_order_unrest",
                        "politics_governance"
                      ],
                      "states": [
                        "tamil-nadu",
                        "karnataka"
                      ],
                      "place": "Tamil Nadu",
                      "risk_score": 35,
                      "risk_level": "guarded",
                      "reading": "Supreme Court dismissed Tamil Nadu's applications seeking extra Cauvery water from Karnataka for the 2026-27 irrigation year.",
                      "event_type": "court_ruling"
                    },
                    {
                      "id": 295701,
                      "label": "Massive fire engulfs Pune’s Timber Market; over 50 shops gutted",
                      "independent_outlets": 13,
                      "articles": 26,
                      "trajectory": "decaying",
                      "first_seen": "2026-11-18T01:18:12.000Z",
                      "last_seen": "2026-11-20T03:26:20.000Z",
                      "sectors": [
                        "public_order_unrest",
                        "crime_law_enforcement"
                      ],
                      "states": [
                        "maharashtra"
                      ],
                      "place": "Pune",
                      "risk_score": 25,
                      "risk_level": "guarded",
                      "reading": "A late-night fire gutted dozens of timber and plywood shops and six houses at Pune's Timber Market in Bhavani Peth; no injuries were reported.",
                      "event_type": "crime"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "bad_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "message": "limit must be a whole number from 1 to 200."
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/stories/{id}": {
      "get": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "getStory",
        "summary": "Get a story",
        "tags": [
          "Stories"
        ],
        "x-scope": "intel:read",
        "x-mcp-tool": "get_story",
        "x-page": "story",
        "description": "One story in full: how Alethman read it (sectors, event type, risk and what it rests on, the parties the reporting names), a summary, its places and every article, how coverage divides, the coverage by country, and the forecasts made about it. A story outside the workspace's sectors and states answers 404, as if it did not exist. When two stories merge, the old id still answers with the merged story; compare `id` with `requested_id`.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The story id, from GET /stories, a signal's `story.id`, an outlook driver or a coordination finding. A whole number of up to 12 digits.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{1,12}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoryDetail"
                },
                "example": {
                  "id": 297641,
                  "requested_id": 297641,
                  "label": "EPFO approves systematic PF withdrawal plan",
                  "proposition": "The EPFO's systematic withdrawal plan will benefit retiring provident fund members.",
                  "independent_outlets": 35,
                  "articles_count": 89,
                  "trajectory": "steady",
                  "first_seen": "2026-11-18T22:24:07.000Z",
                  "last_seen": "2026-11-21T03:51:15.000Z",
                  "tag": {
                    "sectors": [
                      "banking_finance_markets",
                      "politics_governance"
                    ],
                    "event_type": "policy_decision",
                    "theme": "epfo-provident-fund-withdrawal-reforms",
                    "risk_score": 12,
                    "risk_level": "low",
                    "risk_basis": "A routine approval of pension-fund withdrawal flexibility and investment rules by the EPFO board, with no disruption or market shock described.",
                    "reading": "The EPFO board approved reforms easing PF withdrawals, including a systematic withdrawal plan, lower minimum balance and limited alternative fund investment.",
                    "coordinated": false,
                    "coordination_basis": null,
                    "named_by_reporting": [
                      {
                        "kind": "state_agency",
                        "name": "Employees' Provident Fund Organisation",
                        "role": "responder",
                        "article_ids": [
                          132167016,
                          131536578,
                          131475996
                        ],
                        "attribution": "official_statement"
                      }
                    ]
                  },
                  "summary": "The EPFO's Central Board of Trustees met in New Delhi on 19 November 2026 and approved a Systematic Withdrawal Plan letting retiring members draw their provident fund savings in monthly, quarterly or annual instalments while the remainder keeps earning EPF interest. The board also cut the minimum balance to be retained during partial withdrawals from 25% to 10% and restored a two-month wait for final settlement after job loss, down from 12 months; it did not raise the EPS pension. These changes take effect only after formal notification. Nobody disputes the decisions. Where outlets differ is in emphasis: The Times of India, DNA India, Prameya News and The Economic Times present the plan as a clear gain in retirement income and security, while Hindustan Times, India Today, Business Today and others focus on the larger share of savings members can now withdraw. No report so far says when the rules will be notified, and none carries criticism of the plan.",
                  "places": [
                    {
                      "name": "Delhi",
                      "kind": "city",
                      "state": "delhi",
                      "primary": true
                    },
                    {
                      "name": "Mumbai",
                      "kind": "city",
                      "state": "maharashtra",
                      "primary": false
                    },
                    {
                      "name": "Guwahati",
                      "kind": "city",
                      "state": "assam",
                      "primary": false
                    }
                  ],
                  "articles": [
                    {
                      "id": 135003766,
                      "title": "Explained | Major overhaul of PF withdrawals",
                      "url": "https://www.deccanherald.com/india/explained-major-overhaul-of-pf-withdrawals-4225245",
                      "outlet": "Deccan Herald",
                      "published_at": "2026-11-20T09:39:06.000Z",
                      "language": "en",
                      "wire": "PTI"
                    },
                    {
                      "id": 133556770,
                      "title": "EPFO approves systematic PF withdrawal plan, cuts minimum balance requirement to 10%",
                      "url": "https://www.greaterkashmir.com/business/epfo-approves-systematic-pf-withdrawal-plan-cuts-minimum-balance-requirement-to-10-12825076",
                      "outlet": "Greater Kashmir",
                      "published_at": "2026-11-20T02:25:40.000Z",
                      "language": "en",
                      "wire": "PTI"
                    },
                    {
                      "id": 133480577,
                      "title": "EPFO approves periodic PF payouts for retirees, eases withdrawal norms",
                      "url": "https://www.hindustantimes.com/india-news/epfo-approves-periodic-pf-payouts-for-retirees-eases-withdrawal-norms-101795138227494.html",
                      "outlet": "Hindustan Times",
                      "published_at": "2026-11-20T01:44:24.000Z",
                      "language": "en",
                      "wire": null
                    }
                  ],
                  "bloc_finding": {
                    "statement": "Coverage does not split. 8 independent outlets (DNA India, Mathrubhumi, Mint, Odisha Bytes, Prameya News, The Economic Times, The Indian Express, The Times of India) support the proposition \"The EPFO's systematic withdrawal plan will benefit retiring provident fund members.\" and frame it as Steady retirement income.",
                    "evidence_grade": "D",
                    "coordination_likelihood": "low",
                    "what_would_change": "three or more independent outlets carrying the opposing frame would make this a split."
                  },
                  "by_country": [
                    {
                      "country": "IND",
                      "articles": 89,
                      "voices": 35,
                      "supports": 10,
                      "opposes": 0,
                      "neutral": 8,
                      "labelled": 24,
                      "frame": "Easier access to PF savings"
                    }
                  ],
                  "forecasts": []
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "404": {
            "description": "not_found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "not_found",
                    "message": "No story with that id."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/outlooks": {
      "get": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "listOutlooks",
        "summary": "List sector outlooks",
        "tags": [
          "Outlooks"
        ],
        "x-scope": "intel:read",
        "x-mcp-tool": "list_outlooks",
        "x-page": "outlooks",
        "description": "The latest reading for each sector the workspace follows: a risk score and level, the direction against the reading before, a verdict, and the stories driving it. One row per sector, in the workspace's sector order. Readings refresh several times a day.",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Outlook"
                      },
                      "description": "One reading per followed sector."
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "sector": "energy_power",
                      "name": "Energy and power",
                      "quiet": false,
                      "risk_score": 48,
                      "risk_level": "elevated",
                      "previous_score": 61,
                      "direction": "easing",
                      "verdict": "No new Hormuz attack or Tarali ruling emerged in the last 24 hours; the Petroleum Minister again said India can manage oil and gas supply even if West Asia tensions worsen, while the IEA warned of a major Hormuz-linked supply shock and flagged India as the engine of future demand growth. Haryana's Appellate Tribunal kept Eleven Power's Gurugram-Nuh distribution licence suspended, and Karnataka pressed the Centre again on E20 ethanol testing. Coal, power and core-sector output data were strong and crude prices eased, suggesting near-term supply stress is being managed rather than escalating. Watch Hormuz shipping risk and the Gurugram-Nuh licence fight for the next flashpoint.",
                      "drivers": [
                        {
                          "story_id": 300584,
                          "label": "How Hormuz oil shock is India's chance to reset its energy future",
                          "why": "IEA flags Hormuz disruption as a major supply shock with India central to demand growth"
                        },
                        {
                          "story_id": 295835,
                          "label": "Karnataka Flags Excess Ethanol in Petrol Samples, Urges Centre to Review E20 Policy",
                          "why": "Karnataka's renewed E20 challenge keeps fuel-policy friction with the Centre alive"
                        },
                        {
                          "story_id": 295865,
                          "label": "No immediate relief to Eleven Power in APTEL on parallel-distribution licence",
                          "why": "Tribunal's refusal to Eleven Power prolongs Haryana distribution licence dispute"
                        }
                      ],
                      "stories_read": 18,
                      "open_forecasts": 35,
                      "generated_at": "2026-11-20T22:29:38.066Z"
                    },
                    {
                      "sector": "public_order_unrest",
                      "name": "Public order and unrest",
                      "quiet": false,
                      "risk_score": 80,
                      "risk_level": "severe",
                      "previous_score": 76,
                      "direction": "rising",
                      "verdict": "Cyclone Akvan is making landfall near Narsapur-Puri in Odisha, with tens of thousands evacuated, trains cancelled and schools shut. Manipur faces compounding shocks: methanol liquor deaths in Chandel have climbed to 11-15 with over 150 hospitalised, while security forces killed a KCP militant and arrested eight in Imphal West. Bangladesh's Awami League supporters torched police vehicles and a station in Gopalganj, adding border-adjacent risk. Political violence persists in Andhra Pradesh's Pulivendula and Kolkata's TMC-BJP clashes continue after a TMC MP's police questioning. Watch cyclone casualty figures, Manipur's liquor-death fallout, and reaction to the Thiruparankundram lamp lighting.",
                      "drivers": [
                        {
                          "story_id": 299819,
                          "label": "ओडिशा में चक्रवात 'अकवान' का खतरा, अब तक 72 हजार लोगों को सुरक्षित स्थानों पर पहुंचाया गया",
                          "why": "Cyclone landfall near Narsapur-Puri forces mass evacuations and shutdowns"
                        },
                        {
                          "story_id": 301791,
                          "label": "Manipur Spurious Liquor Tragedy: Death Toll Rises To 11, Over 180 Hospitalised",
                          "why": "Methanol liquor deaths in Chandel climb past 11, over 150 hospitalised"
                        },
                        {
                          "story_id": 302765,
                          "label": "Manipur: Militant killed, several others arrested after encounter in Imphal West",
                          "why": "Security forces kill KCP militant, arrest eight in Imphal West"
                        }
                      ],
                      "stories_read": 30,
                      "open_forecasts": 25,
                      "generated_at": "2026-11-21T04:51:50.457Z"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/forecasts": {
      "get": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "listForecasts",
        "summary": "List forecasts",
        "tags": [
          "Forecasts"
        ],
        "x-scope": "intel:read",
        "x-mcp-tool": "list_forecasts",
        "x-page": "forecasts",
        "description": "Dated yes-or-no forecasts in the workspace's sectors, each with its probability, deadline, resolution rule and, once judged, its outcome. `counts` and `track_record` cover every forecast in those sectors, not only the page returned, so they stay the same whatever `limit` you pass.",
        "parameters": [
          {
            "name": "sector",
            "in": "query",
            "required": false,
            "description": "Only this sector. It must be one the workspace follows; another sector returns an empty list, not an error.",
            "schema": {
              "type": "string",
              "enum": [
                "textiles_apparel",
                "metals_mining",
                "trade_imports_exports",
                "agriculture_food",
                "energy_power",
                "infrastructure_transport",
                "manufacturing_industry",
                "it_telecom_tech",
                "pharma_health",
                "banking_finance_markets",
                "real_estate_construction",
                "public_order_unrest",
                "insurgency_terrorism",
                "crime_law_enforcement",
                "defence_borders_foreign",
                "politics_governance",
                "environment_disaster",
                "labour_employment_education",
                "media_information"
              ],
              "description": "A sector key. See Countries and scopes for the list."
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "`open`: deadline ahead. `awaiting`: deadline passed, verdict not in. `resolved`: judged. `all`: every forecast.",
            "schema": {
              "type": "string",
              "enum": [
                "open",
                "awaiting",
                "resolved",
                "all"
              ],
              "default": "all"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many forecasts to return, 1 to 200.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Forecast"
                      },
                      "description": "Forecasts, newest first."
                    },
                    "counts": {
                      "type": "object",
                      "description": "Counts over every forecast in the sectors.",
                      "properties": {
                        "open": {
                          "type": "integer",
                          "description": "Deadline ahead."
                        },
                        "due_this_week": {
                          "type": "integer",
                          "description": "Open, with the deadline in the next 7 days."
                        },
                        "awaiting": {
                          "type": "integer",
                          "description": "Deadline passed, verdict not in."
                        },
                        "resolved": {
                          "type": "integer",
                          "description": "Judged, voided included."
                        }
                      },
                      "required": [
                        "open",
                        "due_this_week",
                        "awaiting",
                        "resolved"
                      ]
                    },
                    "track_record": {
                      "type": "object",
                      "description": "How the forecasts have done.",
                      "properties": {
                        "resolved": {
                          "type": "integer",
                          "description": "Judged true or false."
                        },
                        "void": {
                          "type": "integer",
                          "description": "Judged but voided: the question could not be settled as asked."
                        },
                        "brier_score": {
                          "type": [
                            "number",
                            "null"
                          ],
                          "description": "The Brier score of the forecasts judged true or false: the mean squared gap between probability and outcome, 0 (perfect) to 1. 0.25 is what always saying 50% earns. Null before any is judged."
                        }
                      },
                      "required": [
                        "resolved",
                        "void",
                        "brier_score"
                      ]
                    }
                  },
                  "required": [
                    "data",
                    "counts",
                    "track_record"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "id": 8419,
                      "sector": "energy_power",
                      "question": "Will Cyclone Akvan make landfall on the Andhra Pradesh coast by 21 November 2026?",
                      "probability": 0.65,
                      "made_at": "2026-11-16T15:55:38.996Z",
                      "resolves_by": "2026-11-23T15:55:38.996Z",
                      "resolution_rule": "Yes if IMD or Andhra Pradesh government confirms landfall by the deadline; no if the system weakens or veers away.",
                      "status": "open",
                      "resolved_at": null,
                      "outcome": null,
                      "verdict": null,
                      "rationale": "IMD forecasts intensification and landfall around 20 November, consistent with its track record this season."
                    },
                    {
                      "id": 9610,
                      "sector": "public_order_unrest",
                      "question": "Will Maharashtra's subordinate court employees call off their indefinite strike by 25 Nov 2026?",
                      "probability": 0.4,
                      "made_at": "2026-11-17T22:24:27.754Z",
                      "resolves_by": "2026-11-24T22:24:27.754Z",
                      "resolution_rule": "Resolves yes if reporting confirms the strike is called off or suspended statewide by the deadline.",
                      "status": "open",
                      "resolved_at": null,
                      "outcome": null,
                      "verdict": null,
                      "rationale": "Pay-parity strikes halting hearings usually draw quick government talks, but indefinite action with no reported negotiation yet suggests it could run longer."
                    },
                    {
                      "id": 4253,
                      "sector": "energy_power",
                      "question": "Will the World Meteorological Organization confirm El Niño has reached record strength in a formal bulletin by 22 Nov 2026?",
                      "probability": 0.25,
                      "made_at": "2026-10-22T21:54:44.291Z",
                      "resolves_by": "2026-11-21T21:54:44.291Z",
                      "resolution_rule": "Yes if WMO issues an updated bulletin explicitly stating record-strength El Niño conditions have been reached.",
                      "status": "open",
                      "resolved_at": null,
                      "outcome": null,
                      "verdict": null,
                      "rationale": "WMO's 22 Oct statement used conditional language ('may reach'); formal confirmation of record strength typically lags initial warnings by months."
                    }
                  ],
                  "counts": {
                    "open": 90,
                    "due_this_week": 42,
                    "awaiting": 71,
                    "resolved": 351
                  },
                  "track_record": {
                    "resolved": 294,
                    "void": 57,
                    "brier_score": 0.22685238095238117
                  }
                }
              }
            }
          },
          "400": {
            "description": "bad_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "message": "limit must be a whole number from 1 to 200."
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/coordination": {
      "get": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "listCoordination",
        "summary": "List coordination findings",
        "tags": [
          "Coordination"
        ],
        "x-scope": "intel:read",
        "x-mcp-tool": "list_coordination",
        "x-page": "coordination",
        "description": "Coordination findings touching the workspace's scope (Veritos's campaign view): stories the reporting links into one pattern, each naming who the reporting says runs it, the outlets carrying it hardest and its target, with an evidence grade. `limit` is applied before `grade`, so `grade=A&limit=10` returns the A findings among the latest ten, which may be none.",
        "parameters": [
          {
            "name": "grade",
            "in": "query",
            "required": false,
            "description": "Only findings of this evidence grade.",
            "schema": {
              "type": "string",
              "enum": [
                "A",
                "B",
                "C"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many findings to read (before the grade filter) to return, 1 to 60.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 60,
              "default": 30
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Cluster"
                      },
                      "description": "Findings, newest first."
                    },
                    "note": {
                      "type": "string",
                      "description": "How to read the parties and lift, in one sentence."
                    }
                  },
                  "required": [
                    "data",
                    "note"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "id": 1582,
                      "label": "Idbi bank privatisation fairfax sale strike in Delhi",
                      "pattern": "same_actor",
                      "theme": "idbi-bank-privatisation-fairfax-sale-strike",
                      "grade": "C",
                      "verdict": "Organised by United Forum of IDBI Officers and Employees. Aimed at Government of India. Pushed hardest by Asianet Newsable, Daily Excelsior and Dainik Jagran.",
                      "orchestrator": {
                        "kind": "union",
                        "name": "United Forum of IDBI Officers and Employees",
                        "role": "organiser",
                        "stories": 2,
                        "attribution": "claim_by_actor"
                      },
                      "orchestrator_allies": [],
                      "mediums": [
                        {
                          "outlet": "Asianet Newsable",
                          "articles": 1,
                          "stories": 1,
                          "share": 0.083,
                          "lift": null
                        },
                        {
                          "outlet": "Daily Excelsior",
                          "articles": 1,
                          "stories": 1,
                          "share": 0.083,
                          "lift": null
                        },
                        {
                          "outlet": "Dainik Jagran",
                          "articles": 1,
                          "stories": 1,
                          "share": 0.083,
                          "lift": null
                        }
                      ],
                      "target": {
                        "kind": "state_agency",
                        "name": "Government of India",
                        "role": "target",
                        "stories": 2,
                        "attribution": "claim_by_actor"
                      },
                      "statement": "Organised by United Forum of IDBI Officers and Employees. Aimed at Government of India. Pushed hardest by Asianet Newsable, Daily Excelsior and Dainik Jagran. 2 stories in 1 place, 18 Nov to 20 Nov, 10 independent outlets. United Forum of IDBI Officers and Employees: organiser in 2 of 2 (the actor's own claim); Government of India: target in 2 of 2 (the actor's own claim). Grade C.",
                      "what_would_change": "a second place would make this a multi-site pattern; a third story would raise the grade; a wire or press-release origin for the shared reporting would lower it; actor and theme labels are model readings of the text; a hand check of the articles confirms or overturns the link.",
                      "sectors": [
                        "banking_finance_markets",
                        "public_order_unrest"
                      ],
                      "states": [
                        "delhi"
                      ],
                      "story_ids": [
                        300502,
                        298063
                      ],
                      "independent_outlets": 10,
                      "first_seen": "2026-11-18T10:18:00.000Z",
                      "last_seen": "2026-11-19T22:30:58.000Z",
                      "attributed_by_reporting": [
                        {
                          "name": "United Forum of IDBI Officers and Employees",
                          "kind": "union",
                          "roles": [
                            "organiser"
                          ],
                          "carried_as": "claim_by_actor"
                        },
                        {
                          "name": "Government of India",
                          "kind": "state_agency",
                          "roles": [
                            "target"
                          ],
                          "carried_as": "claim_by_actor"
                        },
                        {
                          "name": "All India IDBI Officers Association",
                          "kind": "union",
                          "roles": [
                            "organiser"
                          ],
                          "carried_as": "claim_by_actor"
                        },
                        {
                          "name": "All India Industrial Development Bank Employees Association",
                          "kind": "union",
                          "roles": [
                            "organiser"
                          ],
                          "carried_as": "claim_by_actor"
                        }
                      ]
                    },
                    {
                      "id": 1604,
                      "label": "Sugarcane procurement price dispute in Haryana",
                      "pattern": "called_action",
                      "theme": "sugarcane-procurement-price-dispute",
                      "grade": "C",
                      "verdict": "Organised by Bharatiya Kisan Union (Doaba). Pushed hardest by The Tribune and Hindustan Times.",
                      "orchestrator": {
                        "kind": "organisation",
                        "name": "Bharatiya Kisan Union (Doaba)",
                        "role": "organiser",
                        "stories": 1,
                        "attribution": "reported"
                      },
                      "orchestrator_allies": [],
                      "mediums": [
                        {
                          "outlet": "The Tribune",
                          "articles": 4,
                          "stories": 1,
                          "share": 0.5,
                          "lift": null
                        },
                        {
                          "outlet": "Hindustan Times",
                          "articles": 2,
                          "stories": 1,
                          "share": 0.25,
                          "lift": null
                        }
                      ],
                      "target": null,
                      "statement": "Organised by Bharatiya Kisan Union (Doaba). Pushed hardest by The Tribune and Hindustan Times. 1 story in 1 place, 18 Nov to 21 Nov, 4 independent outlets. Bharatiya Kisan Union (Doaba): organiser in 1 of 1 (plain reporting). Grade C.",
                      "what_would_change": "an official statement or the actor's own claim carried by two or more outlets would raise the grade; a second place would make this a multi-site pattern; a third story would raise the grade; a wire or press-release origin for the shared reporting would lower it; actor and theme labels are model readings of the text; a hand check of the articles confirms or overturns the link.",
                      "sectors": [
                        "agriculture_food",
                        "public_order_unrest"
                      ],
                      "states": [
                        "haryana"
                      ],
                      "story_ids": [
                        295895
                      ],
                      "independent_outlets": 4,
                      "first_seen": "2026-11-18T02:11:40.000Z",
                      "last_seen": "2026-11-20T20:29:17.000Z",
                      "attributed_by_reporting": [
                        {
                          "name": "Sugarcane Growers' Coordination Committee",
                          "kind": "organisation",
                          "roles": [
                            "organiser"
                          ],
                          "carried_as": "reported"
                        },
                        {
                          "name": "Swabhimani Shetkari Sanghatana",
                          "kind": "organisation",
                          "roles": [
                            "organiser"
                          ],
                          "carried_as": "reported"
                        },
                        {
                          "name": "Bharatiya Kisan Union (Doaba)",
                          "kind": "organisation",
                          "roles": [
                            "organiser"
                          ],
                          "carried_as": "reported"
                        },
                        {
                          "name": "Haryana Kisan Mazdoor Sangharsh Morcha",
                          "kind": "organisation",
                          "roles": [
                            "organiser"
                          ],
                          "carried_as": "reported"
                        }
                      ]
                    }
                  ],
                  "note": "Each finding names its orchestrator, mediums and target from the roles the reporting gives each party; a medium's lift is its share of the finding against its usual share of protest, strike and attack coverage."
                }
              }
            }
          },
          "400": {
            "description": "bad_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "message": "limit must be a whole number from 1 to 200."
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/reports": {
      "get": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "listReports",
        "summary": "List reports",
        "tags": [
          "Reports"
        ],
        "x-scope": "reports:read",
        "x-mcp-tool": "list_reports",
        "x-page": "reports",
        "description": "The workspace's compiled reports, newest first. Page back through older ones with `before`, set to the `created_at` of the last report you have.",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many reports to return, 1 to 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "before",
            "in": "query",
            "required": false,
            "description": "Only reports compiled before this time, as ISO 8601.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ReportSummary"
                      },
                      "description": "Reports, newest first."
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "id": "d35a4dc6-3109-41cf-a2a9-b9a7850ca1d1",
                      "title": "Weekly report, 10 Nov to 17 Nov 2026",
                      "trigger": "scheduled",
                      "period_start": "2026-11-10T03:42:23.800Z",
                      "period_end": "2026-11-17T03:42:23.800Z",
                      "created_at": "2026-11-17T03:42:28.840Z"
                    },
                    {
                      "id": "e64e8f99-0464-4bf3-a423-189e4041b0ef",
                      "title": "Weekly report, 2 Nov to 9 Nov 2026",
                      "trigger": "scheduled",
                      "period_start": "2026-11-02T03:30:22.932Z",
                      "period_end": "2026-11-09T03:30:22.932Z",
                      "created_at": "2026-11-09T03:30:37.749Z"
                    },
                    {
                      "id": "bde58b9c-86ae-4e1b-87e1-5a0b204eedf3",
                      "title": "Weekly report, 19 Oct to 26 Oct 2026",
                      "trigger": "scheduled",
                      "period_start": "2026-10-19T03:30:14.125Z",
                      "period_end": "2026-10-26T03:30:14.125Z",
                      "created_at": "2026-10-26T03:30:18.907Z"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "bad_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "message": "limit must be a whole number from 1 to 200."
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/reports/{id}": {
      "get": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "getReport",
        "summary": "Get a report",
        "tags": [
          "Reports"
        ],
        "x-scope": "reports:read",
        "x-mcp-tool": "get_report",
        "x-page": "report",
        "description": "One report, as structured JSON (the default) or as the Markdown the dashboard prints. Markdown is the one to read, file or hand to a model; JSON is the one to compute on.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The report id, from GET /reports.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "`json`: the report with its structured content. `markdown`: the report as written, `text/markdown`.",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "markdown"
              ],
              "default": "json"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Report"
                },
                "example": {
                  "id": "d35a4dc6-3109-41cf-a2a9-b9a7850ca1d1",
                  "title": "Weekly report, 10 Nov to 17 Nov 2026",
                  "trigger": "scheduled",
                  "period_start": "2026-11-10T03:42:23.800Z",
                  "period_end": "2026-11-17T03:42:23.800Z",
                  "created_at": "2026-11-17T03:42:28.840Z",
                  "content": {
                    "version": 1,
                    "title": "Weekly report, 10 Nov to 17 Nov 2026",
                    "org": "Risk desk",
                    "period": {
                      "end": "2026-11-17T03:42:23.800Z",
                      "hours": 168,
                      "start": "2026-11-10T03:42:23.800Z"
                    },
                    "data_through": "2026-11-17T03:41:59.024Z",
                    "generated_at": "2026-11-17T03:42:23.839Z",
                    "judgements": [
                      {
                        "flag": true,
                        "link": "/sectors/crime_law_enforcement",
                        "text": "Crime and law enforcement reads severe at 80, up 5 from the reading before. Risk is rising on multiple fronts."
                      }
                    ],
                    "memo": {
                      "has": {
                        "stories": true,
                        "readings": true,
                        "coordination": true
                      },
                      "moves": [
                        {
                          "href": "/sectors/infrastructure_transport",
                          "name": "Infrastructure and transport",
                          "delta": 18,
                          "score": 58,
                          "sector": "infrastructure_transport",
                          "previous": 40
                        },
                        {
                          "href": "/sectors/real_estate_construction",
                          "name": "Real estate and construction",
                          "delta": 8,
                          "score": 17,
                          "sector": "real_estate_construction",
                          "previous": 9
                        }
                      ]
                    }
                  }
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string"
                },
                "example": "# Weekly report, 10 Nov to 17 Nov 2026\n\nRisk desk. Period 10 Nov to 17 Nov 2026 (IST). Compiled 17 Nov 2026, 09:12 IST from Alethman's standing readings.\n\nSectors: Textiles and apparel, Metals and mining, Trade, imports and exports, Agriculture and food, Energy and power, Infrastructure and transport, Manufacturing and industry, IT, telecom and technology, Pharma and health, Banking, finance and markets, Real estate and construction, Public order and unrest, Insurgency and terrorism, Crime and law enforcement, Defence, borders and foreign relations, Politics and governance, Environment and disasters, Labour, employment and education, Media and the information space. States: all of India, with national coverage.\n\n## Memo summary\n\n**What changed most** (sector readings against the reading before):\n- Infrastructure and transport: 40 to 58, up 18\n- Real estate and construction: 9 to 17, up 8\n- Manufacturing and industry: 15 to 22, up 7\n\n…\n"
              }
            }
          },
          "400": {
            "description": "bad_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "message": "limit must be a whole number from 1 to 200."
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "404": {
            "description": "not_found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "not_found",
                    "message": "No report with that id in this workspace."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sources": {
      "get": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "listSources",
        "summary": "List sources",
        "tags": [
          "Sources"
        ],
        "x-scope": "sources:read",
        "x-mcp-tool": "list_sources",
        "x-page": "sources",
        "description": "The feeds the workspace follows on top of Alethman's own coverage (a regulator's press releases, a trade body, a local paper), with each feed's health.",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Source"
                      },
                      "description": "The workspace's feeds."
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "id": "34c8efbf-5e0c-4ace-bfeb-816f16bf59df",
                      "url": "https://www.rbi.org.in/pressreleases_rss.xml",
                      "site_url": "http://www.rbi.org.in/",
                      "title": "PRESS RELEASES FROM RBI",
                      "kind": "rss",
                      "status": "active",
                      "last_polled_at": "2026-11-21T04:50:25.731Z",
                      "last_ok_at": "2026-11-21T04:50:25.731Z",
                      "last_error": null,
                      "items": 300,
                      "items_7d": 41,
                      "created_at": "2026-09-30T06:58:18.672Z"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "addSource",
        "summary": "Add a source",
        "tags": [
          "Sources"
        ],
        "x-scope": "sources:write",
        "x-mcp-tool": null,
        "x-page": "add-source",
        "description": "Follow a new feed. Alethman reads the address before saving anything, so a source that answers 201 has already been polled once and holds what that read stored. A site's home page works when it names its feed. A workspace follows up to 50 sources of its own, and up to 20 can be added a minute. Every add is written to the workspace's audit log under the key's name.",
        "parameters": [],
        "requestBody": {
          "required": true,
          "description": "JSON, with `Content-Type: application/json`, at most 4,000 characters.",
          "x-max-body-chars": 4000,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "The feed's address, or a page that names its feed. http or https, at most 2,000 characters.",
                    "format": "uri",
                    "maxLength": 2000
                  }
                },
                "required": [
                  "url"
                ]
              },
              "example": {
                "url": "https://www.rbi.org.in/pressreleases_rss.xml"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Source"
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": {
                    "id": "34c8efbf-5e0c-4ace-bfeb-816f16bf59df",
                    "url": "https://www.rbi.org.in/pressreleases_rss.xml",
                    "site_url": "http://www.rbi.org.in/",
                    "title": "PRESS RELEASES FROM RBI",
                    "kind": "rss",
                    "status": "active",
                    "last_polled_at": "2026-11-21T04:50:25.731Z",
                    "last_ok_at": "2026-11-21T04:50:25.731Z",
                    "last_error": null,
                    "items": 41,
                    "items_7d": 41,
                    "created_at": "2026-11-21T04:50:25.731Z"
                  }
                }
              }
            }
          },
          "400": {
            "description": "bad_request: no JSON content type, a body over 4,000 characters, invalid JSON, a url that is not http(s) or is over 2,000 characters, or more than 20 adds in a minute.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "message": "Twenty new sources a minute is the limit."
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "422": {
            "description": "unprocessable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unprocessable",
                    "message": "That feed is already one of your sources."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sources/{id}": {
      "delete": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "removeSource",
        "summary": "Remove a source",
        "tags": [
          "Sources"
        ],
        "x-scope": "sources:write",
        "x-mcp-tool": null,
        "x-page": "remove-source",
        "description": "Stop following a feed. Its stored items go with it. Written to the workspace's audit log under the key's name.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The source id, from GET /sources.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Removed. No body.",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "404": {
            "description": "not_found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "not_found",
                    "message": "No source with that id in this workspace."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sources/items": {
      "get": {
        "security": [
          {
            "bearer": []
          }
        ],
        "operationId": "listSourceItems",
        "summary": "List source items",
        "tags": [
          "Sources"
        ],
        "x-scope": "sources:read",
        "x-mcp-tool": "list_source_items",
        "x-page": "source-items",
        "description": "What the workspace's own feeds carried, newest first, each item read for sectors and states like any article.",
        "parameters": [
          {
            "name": "source",
            "in": "query",
            "required": false,
            "description": "Only this source's items. A source id from GET /sources.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "sector",
            "in": "query",
            "required": false,
            "description": "Only this sector. It must be one the workspace follows; another sector returns an empty list, not an error.",
            "schema": {
              "type": "string",
              "enum": [
                "textiles_apparel",
                "metals_mining",
                "trade_imports_exports",
                "agriculture_food",
                "energy_power",
                "infrastructure_transport",
                "manufacturing_industry",
                "it_telecom_tech",
                "pharma_health",
                "banking_finance_markets",
                "real_estate_construction",
                "public_order_unrest",
                "insurgency_terrorism",
                "crime_law_enforcement",
                "defence_borders_foreign",
                "politics_governance",
                "environment_disaster",
                "labour_employment_education",
                "media_information"
              ],
              "description": "A sector key. See Countries and scopes for the list."
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "description": "Only this state or union territory.",
            "schema": {
              "type": "string",
              "enum": [
                "andhra-pradesh",
                "arunachal-pradesh",
                "assam",
                "bihar",
                "chhattisgarh",
                "goa",
                "gujarat",
                "haryana",
                "himachal-pradesh",
                "jharkhand",
                "karnataka",
                "kerala",
                "madhya-pradesh",
                "maharashtra",
                "manipur",
                "meghalaya",
                "mizoram",
                "nagaland",
                "odisha",
                "punjab",
                "rajasthan",
                "sikkim",
                "tamil-nadu",
                "telangana",
                "tripura",
                "uttar-pradesh",
                "uttarakhand",
                "west-bengal",
                "andaman-and-nicobar-islands",
                "chandigarh",
                "dadra-and-nagar-haveli-and-daman-and-diu",
                "delhi",
                "jammu-and-kashmir",
                "ladakh",
                "lakshadweep",
                "puducherry"
              ],
              "description": "A state or union territory slug."
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only items published after this time, as ISO 8601, e.g. `2026-11-21T00:00:00Z`.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Words to find in the item's title.",
            "schema": {
              "type": "string",
              "maxLength": 120
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many items to return, 1 to 200.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Requests allowed per minute on this key (120).",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the current minute.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the minute resets, in Unix epoch seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SourceItem"
                      },
                      "description": "Items, newest first."
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "id": 30037,
                      "source": {
                        "id": "34c8efbf-5e0c-4ace-bfeb-816f16bf59df",
                        "title": "PRESS RELEASES FROM RBI"
                      },
                      "title": "Conversion/Switch of State Government Securities",
                      "url": "https://www.rbi.org.in/scripts/BS_PressReleaseDisplay.aspx?prid=64017",
                      "summary": null,
                      "published_at": "2026-11-20T14:36:08.151Z",
                      "fetched_at": "2026-11-20T14:36:08.257Z",
                      "sectors": [
                        "politics_governance"
                      ],
                      "states": []
                    },
                    {
                      "id": 30027,
                      "source": {
                        "id": "34c8efbf-5e0c-4ace-bfeb-816f16bf59df",
                        "title": "PRESS RELEASES FROM RBI"
                      },
                      "title": "RBI to conduct 4-day Variable Rate Repo (VRR) auction under LAF on November 23, 2026",
                      "url": "https://www.rbi.org.in/scripts/BS_PressReleaseDisplay.aspx?prid=64016",
                      "summary": "On a review of current and evolving liquidity conditions in the near term, it has been decided to conduct a Variable Rate Repo (VRR) auction on Monday, November 23, 2026, as under: Sl. No. Notified Amount (₹ crore) Tenor (day) Window Timing Date of Reversal 1 50,000 4 9:30 AM to 10:00 AM November 27, 2026 (Friday) 2. The operational guidelines for the auction will be same as given in Reserve Bank’s Press Release 2021-2022/1572 dated January 20, 2022 . Ajit Prasad Deputy General Manager (Communications) Press Release: 2026-2027/1538",
                      "published_at": "2026-11-20T14:15:10.339Z",
                      "fetched_at": "2026-11-20T14:15:10.342Z",
                      "sectors": [
                        "banking_finance_markets"
                      ],
                      "states": []
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "bad_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "message": "limit must be a whole number from 1 to 200."
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthenticated or invalid_key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "unauthenticated",
                    "message": "Send your key as: Authorization: Bearer alm_live_…"
                  }
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "insufficient_scope",
                    "message": "This key does not carry the sources:write scope."
                  }
                }
              }
            }
          },
          "409": {
            "description": "workspace_not_ready",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "workspace_not_ready",
                    "message": "This workspace has not been set up yet. An owner or admin finishes the walkthrough first."
                  }
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "rate_limited",
                    "message": "120 requests a minute per key. Wait for the window to reset."
                  }
                }
              }
            }
          },
          "500": {
            "description": "internal",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal",
                    "message": "Something failed on our side. Try again; if it persists, tell Alethman."
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "alm_live_ followed by 40 letters and digits",
        "description": "An API key made by a workspace owner or admin under Settings › API keys."
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "description": "Every error has this body.",
        "properties": {
          "error": {
            "type": "object",
            "description": "",
            "properties": {
              "code": {
                "type": "string",
                "description": "A stable, machine-readable code. Branch on this, never on the message.",
                "enum": [
                  "bad_request",
                  "unauthenticated",
                  "invalid_key",
                  "insufficient_scope",
                  "not_found",
                  "workspace_not_ready",
                  "unprocessable",
                  "rate_limited",
                  "internal"
                ]
              },
              "message": {
                "type": "string",
                "description": "One sentence for a person: what was wrong and what to do."
              }
            },
            "required": [
              "code",
              "message"
            ]
          }
        },
        "required": [
          "error"
        ]
      },
      "Signal": {
        "type": "object",
        "description": "One article in the workspace's scope.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The article's id. Stable."
          },
          "title": {
            "type": "string",
            "description": "The headline as the outlet published it, in its own language."
          },
          "url": {
            "type": "string",
            "description": "The article's address on the outlet's site.",
            "format": "uri"
          },
          "published_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the outlet published it (UTC)."
          },
          "language": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO 639-1 code of the headline's language (`en`, `hi`, `ta` …), or null where it was not detected."
          },
          "outlet": {
            "type": "object",
            "description": "Who published it.",
            "properties": {
              "id": {
                "type": "string",
                "description": "The outlet's stable slug."
              },
              "name": {
                "type": "string",
                "description": "The outlet's name."
              }
            },
            "required": [
              "id",
              "name"
            ]
          },
          "sectors": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "textiles_apparel",
                "metals_mining",
                "trade_imports_exports",
                "agriculture_food",
                "energy_power",
                "infrastructure_transport",
                "manufacturing_industry",
                "it_telecom_tech",
                "pharma_health",
                "banking_finance_markets",
                "real_estate_construction",
                "public_order_unrest",
                "insurgency_terrorism",
                "crime_law_enforcement",
                "defence_borders_foreign",
                "politics_governance",
                "environment_disaster",
                "labour_employment_education",
                "media_information"
              ],
              "description": "A sector key. See Countries and scopes for the list."
            },
            "description": "Sectors the article was read as touching. Can be empty."
          },
          "states": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "andhra-pradesh",
                "arunachal-pradesh",
                "assam",
                "bihar",
                "chhattisgarh",
                "goa",
                "gujarat",
                "haryana",
                "himachal-pradesh",
                "jharkhand",
                "karnataka",
                "kerala",
                "madhya-pradesh",
                "maharashtra",
                "manipur",
                "meghalaya",
                "mizoram",
                "nagaland",
                "odisha",
                "punjab",
                "rajasthan",
                "sikkim",
                "tamil-nadu",
                "telangana",
                "tripura",
                "uttar-pradesh",
                "uttarakhand",
                "west-bengal",
                "andaman-and-nicobar-islands",
                "chandigarh",
                "dadra-and-nagar-haveli-and-daman-and-diu",
                "delhi",
                "jammu-and-kashmir",
                "ladakh",
                "lakshadweep",
                "puducherry"
              ],
              "description": "A state or union territory slug."
            },
            "description": "States and union territories the article is about. Empty when it names none (national or foreign news)."
          },
          "story": {
            "type": [
              "object",
              "null"
            ],
            "description": "The story the article was grouped into, or null while it stands alone.",
            "properties": {
              "id": {
                "type": "integer",
                "description": "The story's id; pass it to GET /stories/{id}."
              },
              "label": {
                "type": "string",
                "description": "The story's headline."
              },
              "independent_outlets": {
                "type": "integer",
                "description": "How many independent outlets carry the story."
              }
            },
            "required": [
              "id",
              "label",
              "independent_outlets"
            ]
          }
        },
        "required": [
          "id",
          "title",
          "url",
          "published_at",
          "language",
          "outlet",
          "sectors",
          "states",
          "story"
        ]
      },
      "Outlook": {
        "type": "object",
        "description": "The latest reading for one of the workspace's sectors.",
        "properties": {
          "sector": {
            "type": "string",
            "enum": [
              "textiles_apparel",
              "metals_mining",
              "trade_imports_exports",
              "agriculture_food",
              "energy_power",
              "infrastructure_transport",
              "manufacturing_industry",
              "it_telecom_tech",
              "pharma_health",
              "banking_finance_markets",
              "real_estate_construction",
              "public_order_unrest",
              "insurgency_terrorism",
              "crime_law_enforcement",
              "defence_borders_foreign",
              "politics_governance",
              "environment_disaster",
              "labour_employment_education",
              "media_information"
            ],
            "description": "A sector key. See Countries and scopes for the list."
          },
          "name": {
            "type": "string",
            "description": "The sector's name."
          },
          "quiet": {
            "type": "boolean",
            "description": "True when the sector had too little reporting in its window to read: the score, level, direction and verdict are then null."
          },
          "risk_score": {
            "type": [
              "integer",
              "null"
            ],
            "description": "0 to 100: how much disruption the reporting describes, read by Alethman. Higher is more severe. Comparable across sectors and over time."
          },
          "risk_level": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "low",
              "guarded",
              "elevated",
              "high",
              "severe",
              null
            ],
            "description": "The band the score falls in: `low`, `guarded`, `elevated`, `high` or `severe`. Use it as the headline; band edges are not published and may be tuned."
          },
          "previous_score": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The score of the reading before this one, or null for a first reading."
          },
          "direction": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "rising",
              "steady",
              "easing",
              "new",
              null
            ],
            "description": "How this reading compares with the one before: `rising`, `steady`, `easing`, or `new` for a first reading."
          },
          "verdict": {
            "type": [
              "string",
              "null"
            ],
            "description": "A short paragraph: what is driving the sector now and what to watch."
          },
          "drivers": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "story_id": {
                  "type": "integer",
                  "description": "A story id; pass it to GET /stories/{id}."
                },
                "label": {
                  "type": "string",
                  "description": "The story's headline."
                },
                "why": {
                  "type": "string",
                  "description": "One line: why this story moves the sector."
                }
              },
              "required": [
                "story_id",
                "label",
                "why"
              ]
            },
            "description": "The stories driving the reading, most important first."
          },
          "stories_read": {
            "type": "integer",
            "description": "How many stories the reading weighed."
          },
          "open_forecasts": {
            "type": "integer",
            "description": "Open forecasts in this sector."
          },
          "generated_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When the reading was made."
          }
        },
        "required": [
          "sector",
          "name",
          "quiet",
          "risk_score",
          "risk_level",
          "previous_score",
          "direction",
          "verdict",
          "drivers",
          "stories_read",
          "open_forecasts",
          "generated_at"
        ]
      },
      "Story": {
        "type": "object",
        "description": "Articles about one event, grouped.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The story's id. Stable: when two stories merge, the old id still answers on GET /stories/{id}."
          },
          "label": {
            "type": "string",
            "description": "A headline for the story, from its most representative article."
          },
          "independent_outlets": {
            "type": "integer",
            "description": "Outlets carrying the story independently: syndicated wire copy and copy credited to a news agency count once."
          },
          "articles": {
            "type": "integer",
            "description": "Every article in the story, syndicated copies included."
          },
          "trajectory": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "new",
              "rising",
              "steady",
              "decaying",
              null
            ],
            "description": "Where coverage is heading: `new`, `rising`, `steady` or `decaying`."
          },
          "first_seen": {
            "type": "string",
            "format": "date-time",
            "description": "The first article's publication time."
          },
          "last_seen": {
            "type": "string",
            "format": "date-time",
            "description": "The latest article's publication time."
          },
          "sectors": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "textiles_apparel",
                "metals_mining",
                "trade_imports_exports",
                "agriculture_food",
                "energy_power",
                "infrastructure_transport",
                "manufacturing_industry",
                "it_telecom_tech",
                "pharma_health",
                "banking_finance_markets",
                "real_estate_construction",
                "public_order_unrest",
                "insurgency_terrorism",
                "crime_law_enforcement",
                "defence_borders_foreign",
                "politics_governance",
                "environment_disaster",
                "labour_employment_education",
                "media_information"
              ],
              "description": "A sector key. See Countries and scopes for the list."
            },
            "description": "Sectors the story touches."
          },
          "states": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "andhra-pradesh",
                "arunachal-pradesh",
                "assam",
                "bihar",
                "chhattisgarh",
                "goa",
                "gujarat",
                "haryana",
                "himachal-pradesh",
                "jharkhand",
                "karnataka",
                "kerala",
                "madhya-pradesh",
                "maharashtra",
                "manipur",
                "meghalaya",
                "mizoram",
                "nagaland",
                "odisha",
                "punjab",
                "rajasthan",
                "sikkim",
                "tamil-nadu",
                "telangana",
                "tripura",
                "uttar-pradesh",
                "uttarakhand",
                "west-bengal",
                "andaman-and-nicobar-islands",
                "chandigarh",
                "dadra-and-nagar-haveli-and-daman-and-diu",
                "delhi",
                "jammu-and-kashmir",
                "ladakh",
                "lakshadweep",
                "puducherry"
              ],
              "description": "A state or union territory slug."
            },
            "description": "States and union territories the story is about."
          },
          "place": {
            "type": [
              "string",
              "null"
            ],
            "description": "The story's main place (a city, district or state), or null."
          },
          "risk_score": {
            "type": [
              "integer",
              "null"
            ],
            "description": "0 to 100: how much disruption the reporting describes, read by Alethman. Higher is more severe. Comparable across sectors and over time."
          },
          "risk_level": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "low",
              "guarded",
              "elevated",
              "high",
              "severe",
              null
            ],
            "description": "The band the score falls in: `low`, `guarded`, `elevated`, `high` or `severe`. Use it as the headline; band edges are not published and may be tuned."
          },
          "reading": {
            "type": [
              "string",
              "null"
            ],
            "description": "One sentence: what happened, in plain English whatever the articles' language."
          },
          "event_type": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "protest",
              "strike_bandh",
              "violence_attack",
              "security_operation",
              "policy_decision",
              "court_ruling",
              "election_politics",
              "economic_indicator",
              "corporate_move",
              "trade_action",
              "disaster_accident",
              "crime",
              "diplomatic",
              "other",
              null
            ],
            "description": "What kind of event the story is."
          }
        },
        "required": [
          "id",
          "label",
          "independent_outlets",
          "articles",
          "trajectory",
          "first_seen",
          "last_seen",
          "sectors",
          "states",
          "place",
          "risk_score",
          "risk_level",
          "reading",
          "event_type"
        ]
      },
      "Forecast": {
        "type": "object",
        "description": "A dated, checkable forecast.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The forecast's id."
          },
          "sector": {
            "type": "string",
            "enum": [
              "textiles_apparel",
              "metals_mining",
              "trade_imports_exports",
              "agriculture_food",
              "energy_power",
              "infrastructure_transport",
              "manufacturing_industry",
              "it_telecom_tech",
              "pharma_health",
              "banking_finance_markets",
              "real_estate_construction",
              "public_order_unrest",
              "insurgency_terrorism",
              "crime_law_enforcement",
              "defence_borders_foreign",
              "politics_governance",
              "environment_disaster",
              "labour_employment_education",
              "media_information"
            ],
            "description": "A sector key. See Countries and scopes for the list."
          },
          "question": {
            "type": "string",
            "description": "A yes-or-no question with a date in it."
          },
          "probability": {
            "type": "number",
            "description": "The probability of yes when the forecast was made, 0 to 1. It is never revised.",
            "minimum": 0,
            "maximum": 1
          },
          "made_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the forecast was made."
          },
          "resolves_by": {
            "type": "string",
            "format": "date-time",
            "description": "The deadline."
          },
          "resolution_rule": {
            "type": "string",
            "description": "What counts as yes, written before the outcome was known."
          },
          "status": {
            "type": "string",
            "description": "`open`: the deadline is ahead. `awaiting`: the deadline has passed and no verdict is in yet. `resolved`: judged.",
            "enum": [
              "open",
              "awaiting",
              "resolved"
            ]
          },
          "resolved_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When it was judged, or null."
          },
          "outcome": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "True if it came true, false if not; null until resolved, or when a resolved forecast was voided."
          },
          "verdict": {
            "type": [
              "string",
              "null"
            ],
            "description": "The judgement in a sentence, with what it rests on, or null."
          },
          "rationale": {
            "type": "string",
            "description": "Why the probability was set where it was, written when it was made."
          }
        },
        "required": [
          "id",
          "sector",
          "question",
          "probability",
          "made_at",
          "resolves_by",
          "resolution_rule",
          "status",
          "resolved_at",
          "outcome",
          "verdict",
          "rationale"
        ]
      },
      "Party": {
        "type": "object",
        "description": "A party the reporting names, in one role.",
        "properties": {
          "kind": {
            "type": "string",
            "description": "What the party is: an organisation, movement, party, state agency, armed group, union, company, public official or public figure.",
            "enum": [
              "organisation",
              "movement",
              "party",
              "state_agency",
              "armed_group",
              "union",
              "company",
              "public_official",
              "public_figure"
            ]
          },
          "name": {
            "type": "string",
            "description": "The party's name as the reporting gives it."
          },
          "role": {
            "type": "string",
            "description": "The role the reporting gives it in this finding.",
            "enum": [
              "organiser",
              "claimant",
              "blamed",
              "accused",
              "target",
              "responder"
            ]
          },
          "stories": {
            "type": "integer",
            "description": "In how many of the finding's stories it has that role."
          },
          "attribution": {
            "$ref": "#/components/schemas/Attribution"
          }
        },
        "required": [
          "kind",
          "name",
          "role",
          "stories",
          "attribution"
        ]
      },
      "Attribution": {
        "type": "string",
        "description": "How the reporting attributes the role, strongest first: `official_statement`, `claim_by_actor` (the party's own claim), `reported` (plain reporting), `alleged_by_opponent`, `speculation`.",
        "enum": [
          "official_statement",
          "claim_by_actor",
          "reported",
          "alleged_by_opponent",
          "speculation"
        ]
      },
      "Cluster": {
        "type": "object",
        "description": "A coordination finding: stories the reporting links into one pattern.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The finding's id."
          },
          "label": {
            "type": "string",
            "description": "A short label for the finding."
          },
          "pattern": {
            "type": "string",
            "description": "What joins its stories: `same_actor` (the reporting names one party in each), `same_theme` (a shared theme and sector), or `called_action` (one action described as called or multi-site).",
            "enum": [
              "same_actor",
              "same_theme",
              "called_action"
            ]
          },
          "theme": {
            "type": [
              "string",
              "null"
            ],
            "description": "A slug for the shared theme."
          },
          "grade": {
            "type": "string",
            "description": "The evidence grade, strongest first. `A`: strongest support in the reporting. `B`: a pattern across stories or places. `C`: an early pattern to watch, not yet a finding to rely on. A grade says how much the reporting supports a pattern, not that anyone coordinated it.",
            "enum": [
              "A",
              "B",
              "C"
            ]
          },
          "verdict": {
            "type": "string",
            "description": "The finding in a sentence or two."
          },
          "orchestrator": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Party"
              },
              {
                "type": "null"
              }
            ],
            "description": "The party the reporting names as running it, or null when no one is named."
          },
          "orchestrator_allies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Party"
            },
            "description": "Parties named alongside the orchestrator in the same role."
          },
          "mediums": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "outlet": {
                  "type": "string",
                  "description": "The outlet's name."
                },
                "articles": {
                  "type": "integer",
                  "description": "Its articles in the finding."
                },
                "stories": {
                  "type": "integer",
                  "description": "The finding's stories it carried."
                },
                "share": {
                  "type": "number",
                  "description": "Its share of the finding's articles, 0 to 1."
                },
                "lift": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Its share of this finding against its usual share of protest, strike and attack coverage: above 1 means it carries this more than usual. Null when there is too little history to compare."
                }
              },
              "required": [
                "outlet",
                "articles",
                "stories",
                "share",
                "lift"
              ]
            },
            "description": "The outlets carrying the finding hardest, most first."
          },
          "target": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Party"
              },
              {
                "type": "null"
              }
            ],
            "description": "The party the reporting names as its target, or null."
          },
          "statement": {
            "type": "string",
            "description": "The full finding as one paragraph, citable as it stands."
          },
          "what_would_change": {
            "type": "string",
            "description": "What new reporting would raise, lower or overturn the grade."
          },
          "sectors": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "textiles_apparel",
                "metals_mining",
                "trade_imports_exports",
                "agriculture_food",
                "energy_power",
                "infrastructure_transport",
                "manufacturing_industry",
                "it_telecom_tech",
                "pharma_health",
                "banking_finance_markets",
                "real_estate_construction",
                "public_order_unrest",
                "insurgency_terrorism",
                "crime_law_enforcement",
                "defence_borders_foreign",
                "politics_governance",
                "environment_disaster",
                "labour_employment_education",
                "media_information"
              ],
              "description": "A sector key. See Countries and scopes for the list."
            },
            "description": "Sectors its stories touch."
          },
          "states": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "andhra-pradesh",
                "arunachal-pradesh",
                "assam",
                "bihar",
                "chhattisgarh",
                "goa",
                "gujarat",
                "haryana",
                "himachal-pradesh",
                "jharkhand",
                "karnataka",
                "kerala",
                "madhya-pradesh",
                "maharashtra",
                "manipur",
                "meghalaya",
                "mizoram",
                "nagaland",
                "odisha",
                "punjab",
                "rajasthan",
                "sikkim",
                "tamil-nadu",
                "telangana",
                "tripura",
                "uttar-pradesh",
                "uttarakhand",
                "west-bengal",
                "andaman-and-nicobar-islands",
                "chandigarh",
                "dadra-and-nagar-haveli-and-daman-and-diu",
                "delhi",
                "jammu-and-kashmir",
                "ladakh",
                "lakshadweep",
                "puducherry"
              ],
              "description": "A state or union territory slug."
            },
            "description": "States its stories are in."
          },
          "story_ids": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Its stories; pass each to GET /stories/{id}."
          },
          "independent_outlets": {
            "type": "integer",
            "description": "Independent outlets across its stories."
          },
          "first_seen": {
            "type": "string",
            "format": "date-time",
            "description": "The first article's time."
          },
          "last_seen": {
            "type": "string",
            "format": "date-time",
            "description": "The latest article's time."
          },
          "attributed_by_reporting": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "The party's name."
                },
                "kind": {
                  "type": "string",
                  "description": "What the party is (as Party.kind)."
                },
                "roles": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "The roles the reporting gives it."
                },
                "carried_as": {
                  "$ref": "#/components/schemas/Attribution"
                }
              },
              "required": [
                "name",
                "kind",
                "roles",
                "carried_as"
              ]
            },
            "description": "Every party the reporting names in the finding's stories, with how it is attributed."
          }
        },
        "required": [
          "id",
          "label",
          "pattern",
          "theme",
          "grade",
          "verdict",
          "orchestrator",
          "orchestrator_allies",
          "mediums",
          "target",
          "statement",
          "what_would_change",
          "sectors",
          "states",
          "story_ids",
          "independent_outlets",
          "first_seen",
          "last_seen",
          "attributed_by_reporting"
        ]
      },
      "Source": {
        "type": "object",
        "description": "A feed the workspace follows, on top of Alethman's own coverage.",
        "properties": {
          "id": {
            "type": "string",
            "description": "The source's id.",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "description": "The feed's address.",
            "format": "uri"
          },
          "site_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "The site the feed belongs to."
          },
          "title": {
            "type": "string",
            "description": "The feed's title."
          },
          "kind": {
            "type": "string",
            "description": "`rss` or `atom`.",
            "enum": [
              "rss",
              "atom"
            ]
          },
          "status": {
            "type": "string",
            "description": "`active`: polled about every 20 minutes. `paused`: an owner or admin paused it. `failing`: recent polls failed; see last_error.",
            "enum": [
              "active",
              "paused",
              "failing"
            ]
          },
          "last_polled_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "The last poll, successful or not."
          },
          "last_ok_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "The last successful poll."
          },
          "last_error": {
            "type": [
              "string",
              "null"
            ],
            "description": "Why the last poll failed, or null."
          },
          "items": {
            "type": "integer",
            "description": "Items stored from this feed."
          },
          "items_7d": {
            "type": "integer",
            "description": "Items stored in the last 7 days."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the workspace started following it."
          }
        },
        "required": [
          "id",
          "url",
          "site_url",
          "title",
          "kind",
          "status",
          "last_polled_at",
          "last_ok_at",
          "last_error",
          "items",
          "items_7d",
          "created_at"
        ]
      },
      "SourceItem": {
        "type": "object",
        "description": "One item a followed feed carried.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The item's id."
          },
          "source": {
            "type": "object",
            "description": "The feed it came from.",
            "properties": {
              "id": {
                "type": "string",
                "description": "The source's id.",
                "format": "uuid"
              },
              "title": {
                "type": "string",
                "description": "The source's title."
              }
            },
            "required": [
              "id",
              "title"
            ]
          },
          "title": {
            "type": "string",
            "description": "The item's title."
          },
          "url": {
            "type": "string",
            "description": "The item's address.",
            "format": "uri"
          },
          "summary": {
            "type": [
              "string",
              "null"
            ],
            "description": "The feed's summary of the item, or null."
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When the feed says it was published."
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "description": "When Alethman read it."
          },
          "sectors": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "textiles_apparel",
                "metals_mining",
                "trade_imports_exports",
                "agriculture_food",
                "energy_power",
                "infrastructure_transport",
                "manufacturing_industry",
                "it_telecom_tech",
                "pharma_health",
                "banking_finance_markets",
                "real_estate_construction",
                "public_order_unrest",
                "insurgency_terrorism",
                "crime_law_enforcement",
                "defence_borders_foreign",
                "politics_governance",
                "environment_disaster",
                "labour_employment_education",
                "media_information"
              ],
              "description": "A sector key. See Countries and scopes for the list."
            },
            "description": "Sectors the item was read as touching."
          },
          "states": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "andhra-pradesh",
                "arunachal-pradesh",
                "assam",
                "bihar",
                "chhattisgarh",
                "goa",
                "gujarat",
                "haryana",
                "himachal-pradesh",
                "jharkhand",
                "karnataka",
                "kerala",
                "madhya-pradesh",
                "maharashtra",
                "manipur",
                "meghalaya",
                "mizoram",
                "nagaland",
                "odisha",
                "punjab",
                "rajasthan",
                "sikkim",
                "tamil-nadu",
                "telangana",
                "tripura",
                "uttar-pradesh",
                "uttarakhand",
                "west-bengal",
                "andaman-and-nicobar-islands",
                "chandigarh",
                "dadra-and-nagar-haveli-and-daman-and-diu",
                "delhi",
                "jammu-and-kashmir",
                "ladakh",
                "lakshadweep",
                "puducherry"
              ],
              "description": "A state or union territory slug."
            },
            "description": "States it is about."
          }
        },
        "required": [
          "id",
          "source",
          "title",
          "url",
          "summary",
          "published_at",
          "fetched_at",
          "sectors",
          "states"
        ]
      },
      "ReportSummary": {
        "type": "object",
        "description": "A compiled report.",
        "properties": {
          "id": {
            "type": "string",
            "description": "The report's id.",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "description": "The report's title."
          },
          "trigger": {
            "type": "string",
            "description": "`scheduled` (the workspace's report schedule) or `on_demand` (someone asked for it).",
            "enum": [
              "scheduled",
              "on_demand"
            ]
          },
          "period_start": {
            "type": "string",
            "format": "date-time",
            "description": "Start of the period it covers."
          },
          "period_end": {
            "type": "string",
            "format": "date-time",
            "description": "End of the period it covers."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "When it was compiled."
          }
        },
        "required": [
          "id",
          "title",
          "trigger",
          "period_start",
          "period_end",
          "created_at"
        ]
      },
      "StoryDetail": {
        "type": "object",
        "description": "One story in full.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The story's current id. Differs from requested_id when the story you asked for was merged into this one."
          },
          "requested_id": {
            "type": "integer",
            "description": "The id you asked for."
          },
          "label": {
            "type": "string",
            "description": "The story's headline."
          },
          "proposition": {
            "type": [
              "string",
              "null"
            ],
            "description": "The claim at the centre of the coverage, as one sentence outlets can agree or disagree with."
          },
          "independent_outlets": {
            "type": "integer",
            "description": "Independent outlets carrying it."
          },
          "articles_count": {
            "type": "integer",
            "description": "Every article in it."
          },
          "trajectory": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "new",
              "rising",
              "steady",
              "decaying",
              null
            ],
            "description": "Where coverage is heading: `new`, `rising`, `steady` or `decaying`."
          },
          "first_seen": {
            "type": "string",
            "format": "date-time",
            "description": "The first article's time."
          },
          "last_seen": {
            "type": "string",
            "format": "date-time",
            "description": "The latest article's time."
          },
          "tag": {
            "type": [
              "object",
              "null"
            ],
            "description": "How Alethman read the story, or null before it is read.",
            "properties": {
              "sectors": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "textiles_apparel",
                    "metals_mining",
                    "trade_imports_exports",
                    "agriculture_food",
                    "energy_power",
                    "infrastructure_transport",
                    "manufacturing_industry",
                    "it_telecom_tech",
                    "pharma_health",
                    "banking_finance_markets",
                    "real_estate_construction",
                    "public_order_unrest",
                    "insurgency_terrorism",
                    "crime_law_enforcement",
                    "defence_borders_foreign",
                    "politics_governance",
                    "environment_disaster",
                    "labour_employment_education",
                    "media_information"
                  ],
                  "description": "A sector key. See Countries and scopes for the list."
                },
                "description": "Sectors it touches."
              },
              "event_type": {
                "type": [
                  "string",
                  "null"
                ],
                "enum": [
                  "protest",
                  "strike_bandh",
                  "violence_attack",
                  "security_operation",
                  "policy_decision",
                  "court_ruling",
                  "election_politics",
                  "economic_indicator",
                  "corporate_move",
                  "trade_action",
                  "disaster_accident",
                  "crime",
                  "diplomatic",
                  "other",
                  null
                ],
                "description": "What kind of event the story is."
              },
              "theme": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "A slug for its theme."
              },
              "risk_score": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "0 to 100: how much disruption the reporting describes, read by Alethman. Higher is more severe. Comparable across sectors and over time."
              },
              "risk_level": {
                "type": [
                  "string",
                  "null"
                ],
                "enum": [
                  "low",
                  "guarded",
                  "elevated",
                  "high",
                  "severe",
                  null
                ],
                "description": "The band the score falls in: `low`, `guarded`, `elevated`, `high` or `severe`. Use it as the headline; band edges are not published and may be tuned."
              },
              "risk_basis": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "One sentence: what in the reporting the risk reading rests on."
              },
              "reading": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "One sentence: what happened."
              },
              "coordinated": {
                "type": "boolean",
                "description": "True when the story is part of a coordination finding."
              },
              "coordination_basis": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Why, when coordinated is true; else null."
              },
              "named_by_reporting": {
                "type": "array",
                "items": {
                  "type": "object",
                  "description": "",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "description": "What the party is (as Party.kind)."
                    },
                    "name": {
                      "type": "string",
                      "description": "The party's name."
                    },
                    "role": {
                      "type": "string",
                      "description": "Its role (as Party.role)."
                    },
                    "article_ids": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "description": "The articles that name it so."
                    },
                    "attribution": {
                      "$ref": "#/components/schemas/Attribution"
                    }
                  },
                  "required": [
                    "kind",
                    "name",
                    "role",
                    "article_ids",
                    "attribution"
                  ]
                },
                "description": "The parties the reporting names, each with its role and how it is attributed."
              }
            },
            "required": [
              "sectors",
              "event_type",
              "theme",
              "risk_score",
              "risk_level",
              "risk_basis",
              "reading",
              "coordinated",
              "coordination_basis",
              "named_by_reporting"
            ]
          },
          "summary": {
            "type": [
              "string",
              "null"
            ],
            "description": "A paragraph: what happened, where outlets agree and where they differ."
          },
          "places": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "The place's name."
                },
                "kind": {
                  "type": "string",
                  "description": "`city`, `district`, `state` and so on."
                },
                "state": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The state it is in."
                },
                "primary": {
                  "type": "boolean",
                  "description": "True for the story's main place."
                }
              },
              "required": [
                "name",
                "kind",
                "state",
                "primary"
              ]
            },
            "description": "Places the story names."
          },
          "articles": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "id": {
                  "type": "integer",
                  "description": "The article's id."
                },
                "title": {
                  "type": "string",
                  "description": "Its headline."
                },
                "url": {
                  "type": "string",
                  "description": "Its address.",
                  "format": "uri"
                },
                "outlet": {
                  "type": "string",
                  "description": "The outlet's name."
                },
                "published_at": {
                  "type": "string",
                  "format": "date-time",
                  "description": "When it was published."
                },
                "language": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Its language."
                },
                "wire": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The news agency it credits (PTI, ANI, Reuters …), or null for the outlet's own reporting."
                }
              },
              "required": [
                "id",
                "title",
                "url",
                "outlet",
                "published_at",
                "language",
                "wire"
              ]
            },
            "description": "Every article in the story, newest first."
          },
          "bloc_finding": {
            "type": [
              "object",
              "null"
            ],
            "description": "How coverage of the proposition divides, or null when not yet read.",
            "properties": {
              "statement": {
                "type": "string",
                "description": "Whether coverage splits into camps, and how."
              },
              "evidence_grade": {
                "type": "string",
                "description": "`A` to `D`, strongest first: how clearly coverage splits. `D`: no split.",
                "enum": [
                  "A",
                  "B",
                  "C",
                  "D"
                ]
              },
              "coordination_likelihood": {
                "type": "string",
                "description": "`low`, `moderate` or `elevated`: how far the split looks organised rather than ordinary disagreement.",
                "enum": [
                  "low",
                  "moderate",
                  "elevated"
                ]
              },
              "what_would_change": {
                "type": "string",
                "description": "What new coverage would change the finding."
              }
            },
            "required": [
              "statement",
              "evidence_grade",
              "coordination_likelihood",
              "what_would_change"
            ]
          },
          "by_country": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "",
              "properties": {
                "country": {
                  "type": "string",
                  "description": "ISO 3166-1 alpha-3 code of the outlets' home country."
                },
                "articles": {
                  "type": "integer",
                  "description": "Articles from that country's outlets."
                },
                "voices": {
                  "type": "integer",
                  "description": "Independent outlets from that country."
                },
                "supports": {
                  "type": "integer",
                  "description": "Of those read for stance: outlets that support the proposition."
                },
                "opposes": {
                  "type": "integer",
                  "description": "Outlets that oppose it."
                },
                "neutral": {
                  "type": "integer",
                  "description": "Outlets that report it without a side."
                },
                "labelled": {
                  "type": "integer",
                  "description": "Articles read for stance."
                },
                "frame": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "How that country's outlets frame the story, in a few words."
                }
              },
              "required": [
                "country",
                "articles",
                "voices",
                "supports",
                "opposes",
                "neutral",
                "labelled",
                "frame"
              ]
            },
            "description": "The coverage by the home country of its outlets."
          },
          "forecasts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Forecast"
            },
            "description": "Forecasts made about this story."
          }
        },
        "required": [
          "id",
          "requested_id",
          "label",
          "proposition",
          "independent_outlets",
          "articles_count",
          "trajectory",
          "first_seen",
          "last_seen",
          "tag",
          "summary",
          "places",
          "articles",
          "bloc_finding",
          "by_country",
          "forecasts"
        ]
      },
      "Report": {
        "type": "object",
        "description": "A compiled report with its content.",
        "properties": {
          "id": {
            "type": "string",
            "description": "The report's id.",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "description": "The report's title."
          },
          "trigger": {
            "type": "string",
            "description": "`scheduled` (the workspace's report schedule) or `on_demand` (someone asked for it).",
            "enum": [
              "scheduled",
              "on_demand"
            ]
          },
          "period_start": {
            "type": "string",
            "format": "date-time",
            "description": "Start of the period it covers."
          },
          "period_end": {
            "type": "string",
            "format": "date-time",
            "description": "End of the period it covers."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "When it was compiled."
          },
          "content": {
            "type": "object",
            "description": "The report's structured content, as the dashboard renders it. It carries `version` (the content format; fields are added within a version, never renamed), `title`, `org`, `period`, `data_through`, `generated_at`, and one key per section the workspace's reports include: `judgements`, `memo`, `outlooks`, `stories`, `states`, `forecasts`, `coordination`, `sources`, `products`, `settings`. For a report to read, ask for `format=markdown`."
          }
        },
        "required": [
          "id",
          "title",
          "trigger",
          "period_start",
          "period_end",
          "created_at",
          "content"
        ]
      },
      "Workspace": {
        "type": "object",
        "description": "The workspace a key belongs to.",
        "properties": {
          "workspace": {
            "type": "object",
            "description": "",
            "properties": {
              "name": {
                "type": "string",
                "description": "The workspace's name."
              },
              "slug": {
                "type": "string",
                "description": "Its slug."
              }
            },
            "required": [
              "name",
              "slug"
            ]
          },
          "scope": {
            "type": "object",
            "description": "What the workspace follows. Every endpoint reads through this.",
            "properties": {
              "sectors": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "textiles_apparel",
                    "metals_mining",
                    "trade_imports_exports",
                    "agriculture_food",
                    "energy_power",
                    "infrastructure_transport",
                    "manufacturing_industry",
                    "it_telecom_tech",
                    "pharma_health",
                    "banking_finance_markets",
                    "real_estate_construction",
                    "public_order_unrest",
                    "insurgency_terrorism",
                    "crime_law_enforcement",
                    "defence_borders_foreign",
                    "politics_governance",
                    "environment_disaster",
                    "labour_employment_education",
                    "media_information"
                  ],
                  "description": "A sector key. See Countries and scopes for the list."
                },
                "description": "The sectors it follows. Every list in the API stays inside these."
              },
              "states": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "andhra-pradesh",
                    "arunachal-pradesh",
                    "assam",
                    "bihar",
                    "chhattisgarh",
                    "goa",
                    "gujarat",
                    "haryana",
                    "himachal-pradesh",
                    "jharkhand",
                    "karnataka",
                    "kerala",
                    "madhya-pradesh",
                    "maharashtra",
                    "manipur",
                    "meghalaya",
                    "mizoram",
                    "nagaland",
                    "odisha",
                    "punjab",
                    "rajasthan",
                    "sikkim",
                    "tamil-nadu",
                    "telangana",
                    "tripura",
                    "uttar-pradesh",
                    "uttarakhand",
                    "west-bengal",
                    "andaman-and-nicobar-islands",
                    "chandigarh",
                    "dadra-and-nagar-haveli-and-daman-and-diu",
                    "delhi",
                    "jammu-and-kashmir",
                    "ladakh",
                    "lakshadweep",
                    "puducherry"
                  ],
                  "description": "A state or union territory slug."
                },
                "description": "The states it follows; empty when it follows all of India."
              },
              "all_india": {
                "type": "boolean",
                "description": "True when it follows every state."
              },
              "national": {
                "type": "boolean",
                "description": "True when it also follows national news that names no state."
              }
            },
            "required": [
              "sectors",
              "states",
              "all_india",
              "national"
            ]
          },
          "coverage": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "signals",
                "live",
                "stories",
                "outlooks",
                "forecasts",
                "coordination"
              ]
            },
            "description": "The parts of Alethman the workspace has turned on."
          },
          "reports": {
            "type": "object",
            "description": "Report settings.",
            "properties": {
              "frequency": {
                "type": "string",
                "description": "How often reports are compiled.",
                "enum": [
                  "daily",
                  "weekdays",
                  "weekly",
                  "fortnightly",
                  "monthly",
                  "on_demand"
                ]
              },
              "depth": {
                "type": "string",
                "description": "How long each report runs.",
                "enum": [
                  "brief",
                  "standard",
                  "dossier"
                ]
              },
              "organise": {
                "type": "string",
                "description": "How its stories are grouped.",
                "enum": [
                  "sector",
                  "state",
                  "risk"
                ]
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "judgements",
                    "outlooks",
                    "stories",
                    "states",
                    "forecasts",
                    "coordination",
                    "sources"
                  ]
                },
                "description": "The sections each report includes."
              },
              "screenshots": {
                "type": "boolean",
                "description": "True when reports carry screenshots of key articles."
              },
              "next_at": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "When the next scheduled report is due."
              }
            },
            "required": [
              "frequency",
              "depth",
              "organise",
              "sections",
              "screenshots",
              "next_at"
            ]
          },
          "alerts": {
            "type": "object",
            "description": "Alert settings.",
            "properties": {
              "threshold": {
                "type": "integer",
                "description": "The risk score from which alerts fire, set by the workspace (0 to 100)."
              },
              "kinds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "threshold",
                    "rising",
                    "coordination",
                    "forecast",
                    "report",
                    "source"
                  ]
                },
                "description": "The alert kinds turned on."
              }
            },
            "required": [
              "threshold",
              "kinds"
            ]
          },
          "key": {
            "type": "object",
            "description": "The key that made the request.",
            "properties": {
              "name": {
                "type": "string",
                "description": "The name this key was given."
              },
              "scopes": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "signals:read",
                    "intel:read",
                    "reports:read",
                    "sources:read",
                    "sources:write"
                  ]
                },
                "description": "The scopes this key carries."
              }
            },
            "required": [
              "name",
              "scopes"
            ]
          }
        },
        "required": [
          "workspace",
          "scope",
          "coverage",
          "reports",
          "alerts",
          "key"
        ]
      }
    }
  },
  "x-errors": [
    {
      "status": 400,
      "code": "bad_request",
      "when": "A parameter is out of range or not one of the allowed values, a cursor is not one the API gave, or a POST body is not valid. The message names the parameter and what it accepts."
    },
    {
      "status": 401,
      "code": "unauthenticated",
      "when": "No Authorization header, or one that is not `Bearer <key>`. Answered with `WWW-Authenticate: Bearer realm=\"alethman\"`."
    },
    {
      "status": 401,
      "code": "invalid_key",
      "when": "The key is unknown, revoked or expired, its workspace is suspended, or the person who made it is no longer an active owner or admin. Answered with `WWW-Authenticate: Bearer realm=\"alethman\", error=\"invalid_token\"`."
    },
    {
      "status": 403,
      "code": "insufficient_scope",
      "when": "The key is valid but does not carry the scope this endpoint needs. The message names the scope."
    },
    {
      "status": 404,
      "code": "not_found",
      "when": "No story, report or source with that id in this workspace, or a story outside the workspace's sectors and states."
    },
    {
      "status": 409,
      "code": "workspace_not_ready",
      "when": "The workspace has not been set up yet. An owner or admin finishes the setup walkthrough in the dashboard first."
    },
    {
      "status": 422,
      "code": "unprocessable",
      "when": "POST /sources could not follow the address: it is not a feed, could not be read, is already a source, or the workspace already follows 50 sources of its own."
    },
    {
      "status": 429,
      "code": "rate_limited",
      "when": "More than 120 requests in a minute on one key (wait for `Retry-After` seconds), or more than 30 failed key attempts in a minute from one address (wait 60 seconds)."
    },
    {
      "status": 500,
      "code": "internal",
      "when": "Something failed on Alethman's side. Retry with backoff; if it persists, write to Alethman with the time of the request."
    }
  ],
  "x-scopes": [
    {
      "scope": "signals:read",
      "means": "Read articles in the workspace's scope.",
      "endpoints": [
        "GET /signals"
      ]
    },
    {
      "scope": "intel:read",
      "means": "Read stories, sector outlooks, forecasts and coordination findings.",
      "endpoints": [
        "GET /stories",
        "GET /stories/{id}",
        "GET /outlooks",
        "GET /forecasts",
        "GET /coordination"
      ]
    },
    {
      "scope": "reports:read",
      "means": "Read the workspace's compiled reports, as JSON or Markdown.",
      "endpoints": [
        "GET /reports",
        "GET /reports/{id}"
      ]
    },
    {
      "scope": "sources:read",
      "means": "Read the feeds the workspace follows and what they carried.",
      "endpoints": [
        "GET /sources",
        "GET /sources/items"
      ]
    },
    {
      "scope": "sources:write",
      "means": "Add and remove the workspace's own feeds.",
      "endpoints": [
        "POST /sources",
        "DELETE /sources/{id}"
      ]
    }
  ],
  "x-rate-limits": {
    "per_key_per_minute": 120,
    "bad_key_attempts_per_address_per_minute": 30,
    "source_adds_per_workspace_per_minute": 20
  }
}
