Templates

These routes let you retrieve and update block-theme templates, and retrieve their revisions and autosaves.

Available routes (endpoints are described below):

/wp/v2/templates
/wp/v2/templates/{id}
/wp/v2/templates/{parent}/revisions
/wp/v2/templates/{id}/autosaves

Controller classes:

Resource schema

The schema lists fields returned by the resource. Fields depend on the context and user capabilities.

Field Context Description
id view, edit Resource field.
theme view, edit Resource field.
content view, edit Resource field.
slug view, edit Resource field.
source view, edit Resource field.
origin view, edit Resource field.
type view, edit Resource field.
title view, edit Resource field.
status view, edit Resource field.
wp_id view, edit Resource field.

/wp/v2/templates

An OPTIONS request returns methods, parameters, and the complete schema for the selected route.

$ curl -X OPTIONS -i https://example.com/wp-json/wp/v2/templates

Get data

Request type

GET /wp/v2/templates

Request parameters

$context(string)
Response context: view, embed, or edit.
$page(integer)
Collection page number.
$per_page(integer)
Number of items per page.

Request example

$ curl https://example.com/wp-json/wp/v2/templates

Create, update, and delete

Request type

POST /wp/v2/templates
POST /wp/v2/templates/{id}
DELETE /wp/v2/templates/{id}

Request parameters

$id(string)
Resource field value.
$theme(string)
Resource field value.
$content(string)
Resource field value.
$slug(string)
Resource field value.

Request example

$ curl -X POST https://example.com/wp-json/wp/v2/templates -d status=publish