Save page markup as a draft ability
Replace the page draft with sanitized HTML. Visitors do not see it until publish-page is called.
What it does#
Replace the page draft with sanitized HTML. Visitors do not see it until publish-page is called.
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"
},
"html": {
"type": "string",
"maxLength": 1048576
},
"title": {
"type": "string"
}
},
"required": [
"page_id",
"rev",
"html"
],
"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.