Kindly EditDocumentationTry the editor

Save a client design draft ability

Validate and save a complete client design as an unpublished draft. It does not change the public site until publish-client-design is called.

What it does#

Validate and save a complete client design as an unpublished draft. It does not change the public site until publish-client-design 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": {
    "rev": {
      "type": "string"
    },
    "design": {
      "type": "object"
    }
  },
  "required": [
    "rev",
    "design"
  ],
  "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.