{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vaquill-ai/json-schema/vaquill-ai-chronology-event-update-request-schema.json",
  "title": "ChronologyEventUpdateRequest",
  "description": "Fields to change. Omitted fields are left alone.\n\nAn explicit null clears `description` or `eventDateEnd`. Every other field\nhere is backed by a NOT NULL column, so a null for one is refused by name\nrather than passed to the database.\n\n`documentId` is deliberately not patchable: which document an event came from\nis provenance, and re-pointing it would make an extracted event claim a source\nit was never read from.",
  "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/ChronologyEventUpdateRequest",
  "properties": {
    "eventDate": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "title": "Eventdate",
      "description": "When it happened."
    },
    "eventDateEnd": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "title": "Eventdateend",
      "description": "The end of a date range. Send null to clear it."
    },
    "eventDateApproximate": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Eventdateapproximate",
      "description": "True when the date is an estimate rather than a record."
    },
    "eventType": {
      "anyOf": [
        {
          "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"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Eventtype",
      "description": "What happened."
    },
    "category": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "contract_event",
            "court_filing",
            "correspondence",
            "payment_financial",
            "deadline_notice",
            "meeting_hearing",
            "legislative",
            "case_law",
            "historical",
            "corporate",
            "regulatory",
            "employment",
            "milestone",
            "other"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Category",
      "description": "Which swim lane it joins."
    },
    "title": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 500,
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Title",
      "description": "A one-line description."
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 5000
        },
        {
          "type": "null"
        }
      ],
      "title": "Description",
      "description": "The longer account. Send null to clear it."
    },
    "parties": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array",
          "maxItems": 50
        },
        {
          "type": "null"
        }
      ],
      "title": "Parties",
      "description": "Who was involved. Replaces the whole list."
    },
    "tags": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array",
          "maxItems": 30
        },
        {
          "type": "null"
        }
      ],
      "title": "Tags",
      "description": "Free-form labels. Replaces the whole list."
    },
    "significance": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "high",
            "medium",
            "low"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Significance",
      "description": "`high`, `medium` or `low`."
    }
  },
  "additionalProperties": false,
  "type": "object"
}