{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/account/list-account-changes-request.json",
  "title": "List Account Changes Request",
  "description": "Read a durable, ordered feed of material changes to AdCP-visible state for one account. Use a latest checkpoint before snapshot bootstrap, then drain from that cursor to close the bootstrap race.",
  "x-tool-summary": "List durable changes to authoritative AdCP-visible state for one account.",
  "type": "object",
  "properties": {
    "adcp_version": {
      "type": "string",
      "description": "Release-precision AdCP version. Flattened here so emitted MCP tool input schemas remain plain root objects for clients that reject top-level combinators.",
      "pattern": "^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?)?$"
    },
    "adcp_major_version": {
      "type": "integer",
      "deprecated": true,
      "description": "Deprecated major-only version pin retained through 3.x.",
      "minimum": 1,
      "maximum": 99
    },
    "account": {
      "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/account-ref.json",
      "description": "Account whose change feed to read. The resolved account and returned cursor are bound to the authenticated principal."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque checkpoint returned by a prior call using the same authenticated principal, authorization scope epoch, account, and normalized filters. Returns changes strictly after the scanned high-water represented by this value. Sellers MUST reject reuse under a different principal, account, or filter set with INVALID_REQUEST at field cursor; an authorization-scope epoch change returns CURSOR_EXPIRED and requires snapshot rebootstrap.",
      "minLength": 1,
      "maxLength": 4096
    },
    "starting_position": {
      "type": "string",
      "enum": [
        "earliest",
        "latest"
      ],
      "default": "earliest",
      "description": "Initial position when cursor is absent. Mutually exclusive with cursor; sellers enforce this semantic rule at runtime so the emitted MCP input schema can remain a plain root object. earliest intentionally begins at the oldest retained change. latest returns a checkpoint at the current seller-ingestion high-water and is used before a race-free snapshot bootstrap."
    },
    "resource_types": {
      "type": "array",
      "description": "Optional exact resource-type filter. The cursor is bound to the normalized filter. Unknown resource types are allowed for forward compatibility.",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100,
        "pattern": "^[a-z][a-z0-9_.-]{0,99}$"
      },
      "minItems": 1,
      "maxItems": 50,
      "uniqueItems": true
    },
    "max_results": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 50,
      "description": "Maximum changes to return. Sellers still scan through nonmatching records and advance the returned cursor."
    },
    "context": {
      "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/context.json"
    },
    "ext": {
      "$ref": "https://adcontextprotocol.org/schemas/3.2.0-beta.9/core/ext.json"
    }
  },
  "required": [
    "account"
  ],
  "additionalProperties": true,
  "examples": [
    {
      "description": "Acquire a pre-bootstrap checkpoint",
      "data": {
        "adcp_version": "3.2",
        "account": {
          "account_id": "acc_luma_shared"
        },
        "starting_position": "latest",
        "max_results": 100
      }
    }
  ]
}