Kindly EditDocumentationTry the editor

Edit a page draft ability

Apply up to 100 structured changes to the revision just read. All changes succeed together and are saved only as an unpublished draft.

What it does#

Apply up to 100 structured changes to the revision just read. All changes succeed together and are saved only as an unpublished draft.

Access and execution#

This WordPress Ability runs as the authenticated caller. Site AI access, relevant content permissions, and feature-specific code or design gates still apply. See Automation access for authentication and transport setup. Discover the ability through the installed WordPress Abilities interface rather than guessing a different REST path.

Input schema#

{
  "type": "object",
  "properties": {
    "page_id": {
      "type": "integer"
    },
    "rev": {
      "type": "string"
    },
    "ops": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "object"
      }
    },
    "path_mode": {
      "type": "string",
      "enum": [
        "revision",
        "sequential"
      ],
      "default": "revision",
      "description": "Revision paths retain the identities returned by get-page throughout this batch. Sequential paths resolve against the outline after every preceding operation, including newly inserted content."
    },
    "title": {
      "type": "string"
    }
  },
  "required": [
    "page_id",
    "rev",
    "ops"
  ],
  "additionalProperties": false
}

Output schema#

{
  "type": "object"
}

Integration behavior#

Required fields and additionalProperties restrictions are part of the contract. Preserve returned revision tokens as opaque values. If a write reports a conflict, fetch the current source and reconcile before retrying. Draft and publication are separate operations unless this ability explicitly publishes. A successful schema match does not bypass content validation.

Errors use WordPress error responses; inspect their code, message, and status rather than assuming every non-success is retryable. Do not include credentials in diagnostic logs.

About this page

Documents Kindly Edit 0.9.16. Source: includes/abilities.php, includes/advanced-code-api.php, includes/advanced-php-api.php, includes/theme-design.php. Theme choices and account permissions can change which controls appear.

Type a word or phrase to search the full documentation.