{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vaquill-ai/json-schema/vaquill-ai-chronology-event-create-request-schema.json",
  "title": "ChronologyEventCreateRequest",
  "description": "A hand-entered event.\n\nCreated events are recorded as NOT ai-extracted and carry no confidence,\nwhich is what keeps them distinguishable from the pipeline's output forever.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vaquill-ai-chronology-api-openapi.yml#/components/schemas/ChronologyEventCreateRequest",
  "properties": {
    "eventDate": {
      "type": "string",
      "format": "date",
      "title": "Eventdate",
      "description": "When it happened. Required; there is no undated event."
    },
    "eventDateEnd": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "title": "Eventdateend",
      "description": "The end of a date range."
    },
    "eventDateApproximate": {
      "type": "boolean",
      "title": "Eventdateapproximate",
      "description": "True when the date is your best estimate.",
      "default": false
    },
    "eventType": {
      "type": "string",
      "enum": [
        "signed",
        "executed",
        "filed",
        "served",
        "effective",
        "expired",
        "terminated",
        "notice_sent",
        "notice_received",
        "payment",
        "hearing",
        "meeting",
        "judgment",
        "order",
        "correspondence",
        "amended",
        "enacted",
        "published",
        "decided",
        "incident",
        "referenced",
        "founded",
        "incorporated",
        "appointed",
        "resigned",
        "acquired",
        "launched",
        "awarded",
        "approved",
        "registered",
        "commenced",
        "completed",
        "transferred",
        "invested",
        "dissolved",
        "announced",
        "renewed",
        "other"
      ],
      "title": "Eventtype",
      "description": "What happened.",
      "default": "other"
    },
    "category": {
      "type": "string",
      "enum": [
        "contract_event",
        "court_filing",
        "correspondence",
        "payment_financial",
        "deadline_notice",
        "meeting_hearing",
        "legislative",
        "case_law",
        "historical",
        "corporate",
        "regulatory",
        "employment",
        "milestone",
        "other"
      ],
      "title": "Category",
      "description": "Which swim lane it joins.",
      "default": "other"
    },
    "title": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "title": "Title",
      "description": "A one-line description."
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 5000
        },
        {
          "type": "null"
        }
      ],
      "title": "Description",
      "description": "The longer account, when there is one."
    },
    "parties": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "maxItems": 50,
      "title": "Parties",
      "description": "Who was involved, by name."
    },
    "tags": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "maxItems": 30,
      "title": "Tags",
      "description": "Free-form labels of your own."
    },
    "significance": {
      "type": "string",
      "enum": [
        "high",
        "medium",
        "low"
      ],
      "title": "Significance",
      "description": "`high`, `medium` or `low`.",
      "default": "medium"
    },
    "documentId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Documentid",
      "description": "Link the event to a `doc_` document in this matter. The reference is checked against your organization AND this matter before it is written."
    },
    "sourcePageNumber": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1.0
        },
        {
          "type": "null"
        }
      ],
      "title": "Sourcepagenumber",
      "description": "The page in that document this event comes from."
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "eventDate",
    "title"
  ]
}