Kindly EditDocumentationTry the editor

templates/{id} REST endpoint

Manage saved layout copies in the template library.

Endpoint#

Manage saved layout copies in the template library.

/wp-json/cantata-edit/v1/templates/(?P<id>\d+)

Named regular-expression groups in this registered route are path parameters. Replace them with an actual matching value when constructing a request.

GET#

This operation uses a server permission callback. Browser clients need an authenticated WordPress session and REST nonce. The server checks the relevant caller capability and feature gates.

Permission expression in this release:

'permission_callback' => static fn( $req ) => cantata_edit_template_access() && CANTATA_EDIT_TEMPLATE_TYPE === get_post_type( (int) $req['id'] ) && 'publish' === get_post_status( (int) $req['id'] ),

Registered argument schema#

[]

An empty schema means the route did not declare arguments in its registration. It does not mean that the callback accepts arbitrary data or has no required body fields. Callback-level validation remains authoritative.

Callback input keys#

id. This literal-key inventory supplements the registered schema; nested objects and downstream validators can define additional structure.

Implementation#

DELETE#

This operation uses a server permission callback. Browser clients need an authenticated WordPress session and REST nonce. The server checks the relevant caller capability and feature gates.

Permission expression in this release:

'permission_callback' => static fn( $req ) => cantata_edit_template_access() && CANTATA_EDIT_TEMPLATE_TYPE === get_post_type( (int) $req['id'] ) && current_user_can( 'delete_post', (int) $req['id'] ),

Registered argument schema#

[]

An empty schema means the route did not declare arguments in its registration. It does not mean that the callback accepts arbitrary data or has no required body fields. Callback-level validation remains authoritative.

Callback input keys#

id. This literal-key inventory supplements the registered schema; nested objects and downstream validators can define additional structure.

Client handling#

Use HTTPS on production sites. Treat authentication failures, validation errors, missing records, and stale-revision conflicts as different outcomes. Read the returned WordPress error code and message. Before retrying a timed-out mutation, determine whether the first request succeeded. Prefer the documented higher-level editor or Ability workflow when an endpoint coordinates several metadata owners.

About this page

Documents Kindly Edit 0.9.16. Source: includes/templates.php:197, includes/templates.php:198, includes/templates.php:205, includes/templates.php:206. Theme choices and account permissions can change which controls appear.

Type a word or phrase to search the full documentation.