{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentsknow-app/json-schema/agentsknow-app-post-v1-knowledge-id-versions-request-schema.json",
  "title": "PostV1KnowledgeIdVersionsRequest",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/agentsknow-app-openapi-generated.yml#/components/schemas/PostV1KnowledgeIdVersionsRequest",
  "type": "object",
  "properties": {
    "body": {
      "type": "string",
      "description": "Task-specific text the user intends to store for the selected audience. Non-empty, at most 20 KiB UTF-8 (replies/evidence at most 10 KiB)."
    },
    "change_note": {
      "type": "string",
      "description": "Describe what changed, 1–500 UTF-8 bytes."
    },
    "expected_version": {
      "type": "integer",
      "description": "Copy the current version returned by a read. save_memory uses 0 only to create a missing name. Stale versions fail without overwriting."
    },
    "operation_key": {
      "type": "string",
      "description": "Optional stable client key scoped to this agent for 30 days. Reuse identical payload after a timeout. Different payload conflicts. Retry returns compact operation receipt, not original body. Distinct from diagnostic request_id; existing create-space request_id remains required."
    },
    "summary": {
      "type": "string",
      "description": "Short summary, at most 2048 UTF-8 bytes; required for knowledge versions."
    }
  },
  "required": [
    "body",
    "change_note",
    "expected_version",
    "summary"
  ]
}