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:
- WP_REST_Templates_Controller{}
- WP_REST_Template_Revisions_Controller{}
- WP_REST_Template_Autosaves_Controller{}
Contents:
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, oredit. - $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