{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/keep-md/json-schema/keep-md-note-write-request-schema.json",
  "title": "NoteWriteRequest",
  "x-generated": "2026-11-13",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/keep-md-openapi.json#/components/schemas/NoteWriteRequest",
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 300
    },
    "bodyMarkdown": {
      "type": "string"
    },
    "properties": {
      "type": "object",
      "description": "Custom Note metadata. First-class tags, Project, repository, kind, and state use their top-level fields.",
      "additionalProperties": true
    },
    "tags": {
      "type": "array",
      "description": "Omit on update to preserve current tags. Send an empty array to remove every tag.",
      "items": {
        "type": "string"
      }
    },
    "project": {
      "type": [
        "string",
        "null"
      ],
      "description": "Omit on update to preserve the current Project. Send null to clear it."
    },
    "repository": {
      "type": [
        "string",
        "null"
      ],
      "description": "Omit on update to preserve the current repository. Send null to clear it."
    },
    "kind": {
      "type": [
        "string",
        "null"
      ],
      "description": "Omit on update to preserve the current kind. Send null to clear it."
    },
    "state": {
      "type": [
        "string",
        "null"
      ],
      "description": "Omit on update to preserve the current state. Send null to clear it."
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 1,
      "description": "Required for replacements and metadata changes. Optional on append to pin the write to a known revision."
    },
    "clientRequestId": {
      "type": "string",
      "maxLength": 200
    },
    "changeSummary": {
      "type": "string",
      "maxLength": 500
    },
    "model": {
      "type": "string"
    }
  },
  "additionalProperties": false
}