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.