GetYearResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/edgechat-ai/json-schema/edgechat-ai-get-year-response-schema.json",
  "title": "GetYearResponse",
  "description": "Shape read from a live answer of 2026-10-07; fields may be added, never renamed or removed. Every field is optional: an answer carries the fields of its own branch.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/edgechat-ai-year-api-openapi.yml#/components/schemas/GetYearResponse",
  "type": "object",
  "properties": {
    "year": {
      "type": "integer"
    },
    "total": {
      "type": "integer",
      "description": "The events in the index for this answer. An index holds at most 2000; when it is full the answer is a sample and says `sampled`."
    },
    "page": {
      "type": "integer"
    },
    "pages": {
      "type": "integer"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        }
      }
    },
    "license": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "summary": {
          "type": "string"
        }
      }
    },
    "sampled": {
      "type": "boolean",
      "description": "true when the index holds its cap (2000): `total` counts the sample, not every dated sentence."
    },
    "cap": {
      "type": "integer"
    }
  }
}