{"id":147376,"date":"2023-04-26T10:55:33","date_gmt":"2023-04-26T10:55:33","guid":{"rendered":"https:\/\/developer.wordpress.org\/rest-api\/reference\/wp_template-revisions\/"},"modified":"2024-01-16T20:30:11","modified_gmt":"2024-01-16T20:30:11","slug":"wp_template-revisions","status":"publish","type":"rest-api-handbook","link":"https:\/\/developer.wordpress.org\/rest-api\/reference\/wp_template-revisions\/","title":{"rendered":"Template Revisions"},"content":{"rendered":"
\n
\n

Schema<\/h2>\n

The schema defines all the fields that exist within a template revision record. Any response from these endpoints can be expected to contain the fields below unless the `_filter` query parameter is used or the schema field only appears in a specific context.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
\n author<\/code>\n <\/td>\n\n The ID for the author of the revision.<\/p>\n

\n JSON data type: integer <\/p>\n

Context: view<\/code>, edit<\/code>, embed<\/code><\/p>\n<\/td>\n<\/tr>\n

\n date<\/code>\n <\/td>\n\n The date the revision was published, in the site's timezone.<\/p>\n

\n JSON data type: string,
\n Format: datetime (details<\/a>)\n <\/p>\n

Context: view<\/code>, edit<\/code>, embed<\/code><\/p>\n<\/td>\n<\/tr>\n

\n date_gmt<\/code>\n <\/td>\n\n The date the revision was published, as GMT.<\/p>\n

\n JSON data type: string,
\n Format: datetime (details<\/a>)\n <\/p>\n

Context: view<\/code>, edit<\/code><\/p>\n<\/td>\n<\/tr>\n

\n guid<\/code>\n <\/td>\n\n GUID for the revision, as it exists in the database.<\/p>\n

\n JSON data type: string <\/p>\n

Context: view<\/code>, edit<\/code><\/p>\n<\/td>\n<\/tr>\n

\n id<\/code>\n <\/td>\n\n Unique identifier for the revision.<\/p>\n

\n JSON data type: integer <\/p>\n

Context: view<\/code>, edit<\/code>, embed<\/code><\/p>\n<\/td>\n<\/tr>\n

\n modified<\/code>\n <\/td>\n\n The date the revision was last modified, in the site's timezone.<\/p>\n

\n JSON data type: string,
\n Format: datetime (details<\/a>)\n <\/p>\n

Context: view<\/code>, edit<\/code><\/p>\n<\/td>\n<\/tr>\n

\n modified_gmt<\/code>\n <\/td>\n\n The date the revision was last modified, as GMT.<\/p>\n

\n JSON data type: string,
\n Format: datetime (details<\/a>)\n <\/p>\n

Context: view<\/code>, edit<\/code><\/p>\n<\/td>\n<\/tr>\n

\n parent<\/code>\n <\/td>\n\n The ID for the parent of the revision.<\/p>\n

\n JSON data type: integer <\/p>\n

Context: view<\/code>, edit<\/code>, embed<\/code><\/p>\n<\/td>\n<\/tr>\n

\n slug<\/code>\n <\/td>\n\n An alphanumeric identifier for the revision unique to its type.<\/p>\n

\n JSON data type: string <\/p>\n

Context: view<\/code>, edit<\/code>, embed<\/code><\/p>\n<\/td>\n<\/tr>\n

\n title<\/code>\n <\/td>\n\n Title of template.<\/p>\n

\n JSON data type: object or string <\/p>\n

Context: embed<\/code>, view<\/code>, edit<\/code><\/p>\n<\/td>\n<\/tr>\n

\n content<\/code>\n <\/td>\n\n Content of template.<\/p>\n

\n JSON data type: object or string <\/p>\n

Context: embed<\/code>, view<\/code>, edit<\/code><\/p>\n<\/td>\n<\/tr>\n<\/table><\/div>\n<\/section>\n

\n
\n
\n

List Template Revisions<\/h2>\n

Query this endpoint to retrieve a collection of template revisions. The response you receive can be controlled and filtered using the URL query parameters below.<\/p>\n

Definition<\/h3>\n

GET \/wp\/v2\/templates\/<parent>\/revisions<\/code><\/p>\n

Example Request<\/h3>\n

$ curl https:\/\/example.com\/wp-json\/wp\/v2\/templates\/<parent>\/revisions<\/code>\n <\/div>\n

\n

Arguments<\/h3>\n\n\n\n\n\n\n\n\n\n\n\n
\n parent<\/code>\n <\/td>\n\n The ID for the parent of the revision.\n <\/td>\n<\/tr>\n
\n context<\/code>\n <\/td>\n\n Scope under which the request is made; determines fields present in response.<\/p>\n

\n Default: view<\/code>\n <\/p>\n

One of: view<\/code>, embed<\/code>, edit<\/code>\n <\/td>\n<\/tr>\n

\n page<\/code>\n <\/td>\n\n Current page of the collection.<\/p>\n

\n Default: 1<\/code>\n <\/p>\n<\/td>\n<\/tr>\n

\n per_page<\/code>\n <\/td>\n\n Maximum number of items to be returned in result set.\n <\/td>\n<\/tr>\n
\n search<\/code>\n <\/td>\n\n Limit results to those matching a string.\n <\/td>\n<\/tr>\n
\n exclude<\/code>\n <\/td>\n\n Ensure result set excludes specific IDs.\n <\/td>\n<\/tr>\n
\n include<\/code>\n <\/td>\n\n Limit result set to specific IDs.\n <\/td>\n<\/tr>\n
\n offset<\/code>\n <\/td>\n\n Offset the result set by a specific number of items.\n <\/td>\n<\/tr>\n
\n order<\/code>\n <\/td>\n\n Order sort attribute ascending or descending.<\/p>\n

\n Default: desc<\/code>\n <\/p>\n

One of: asc<\/code>, desc<\/code>\n <\/td>\n<\/tr>\n

\n orderby<\/code>\n <\/td>\n\n Sort collection by object attribute.<\/p>\n

\n Default: date<\/code>\n <\/p>\n

One of: date<\/code>, id<\/code>, include<\/code>, relevance<\/code>, slug<\/code>, include_slugs<\/code>, title<\/code>\n <\/td>\n<\/tr>\n<\/table><\/div>\n<\/section>\n

\n
\n

Retrieve a Template Revision<\/h2>\n

Definition & Example Request<\/h3>\n

GET \/wp\/v2\/templates\/<parent>\/revisions\/<id><\/code><\/p>\n

Query this endpoint to retrieve a specific template revision record.<\/p>\n

$ curl https:\/\/example.com\/wp-json\/wp\/v2\/templates\/<parent>\/revisions\/<id><\/code>\n <\/div>\n

\n

Arguments<\/h3>\n\n\n\n\n
\n parent<\/code>\n <\/td>\n\n The ID for the parent of the revision.\n <\/td>\n<\/tr>\n
\n id<\/code>\n <\/td>\n\n Unique identifier for the revision.\n <\/td>\n<\/tr>\n
\n context<\/code>\n <\/td>\n\n Scope under which the request is made; determines fields present in response.<\/p>\n

\n Default: view<\/code>\n <\/p>\n

One of: view<\/code>, embed<\/code>, edit<\/code>\n <\/td>\n<\/tr>\n<\/table><\/div>\n<\/section>\n

\n
\n

Delete a Template Revision<\/h2>\n

Arguments<\/h3>\n\n\n\n\n
\n parent<\/code>\n <\/td>\n\n The ID for the parent of the revision.\n <\/td>\n<\/tr>\n
\n id<\/code>\n <\/td>\n\n Unique identifier for the revision.\n <\/td>\n<\/tr>\n
\n force<\/code>\n <\/td>\n\n Required to be true, as revisions do not support trashing.\n <\/td>\n<\/tr>\n<\/table><\/div>\n
\n

Definition<\/h3>\n

DELETE \/wp\/v2\/templates\/<parent>\/revisions\/<id><\/code><\/p>\n

Example Request<\/h3>\n

$ curl -X DELETE https:\/\/example.com\/wp-json\/wp\/v2\/templates\/<parent>\/revisions\/<id><\/code>\n <\/div>\n<\/section>\n

\n
\n

Retrieve a Template Revision<\/h2>\n

Definition & Example Request<\/h3>\n

GET \/wp\/v2\/templates\/<id>\/autosaves<\/code><\/p>\n

Query this endpoint to retrieve a specific template revision record.<\/p>\n

$ curl https:\/\/example.com\/wp-json\/wp\/v2\/templates\/<id>\/autosaves<\/code>\n <\/div>\n

\n

Arguments<\/h3>\n\n\n\n
\n parent<\/code>\n <\/td>\n\n The ID for the parent of the autosave.\n <\/td>\n<\/tr>\n
\n context<\/code>\n <\/td>\n\n Scope under which the request is made; determines fields present in response.<\/p>\n

\n Default: view<\/code>\n <\/p>\n

One of: view<\/code>, embed<\/code>, edit<\/code>\n <\/td>\n<\/tr>\n<\/table><\/div>\n<\/section>\n

\n
\n

Create a Template Revision<\/h2>\n

Arguments<\/h3>\n\n\n\n\n\n\n\n\n\n\n
\n parent<\/a><\/code>\n <\/td>\n\n The ID for the parent of the autosave.\n <\/td>\n<\/tr>\n
\n slug<\/a><\/code>\n <\/td>\n\n Unique slug identifying the template.\n <\/td>\n<\/tr>\n
\n theme<\/a><\/code>\n <\/td>\n\n Theme identifier for the template.\n <\/td>\n<\/tr>\n
\n type<\/a><\/code>\n <\/td>\n\n Type of template.\n <\/td>\n<\/tr>\n
\n content<\/a><\/code>\n <\/td>\n\n Content of template.\n <\/td>\n<\/tr>\n
\n title<\/a><\/code>\n <\/td>\n\n Title of template.\n <\/td>\n<\/tr>\n
\n description<\/a><\/code>\n <\/td>\n\n Description of template.\n <\/td>\n<\/tr>\n
\n status<\/a><\/code>\n <\/td>\n\n Status of template.
\n One of: publish<\/code>, future<\/code>, draft<\/code>, pending<\/code>, private<\/code>\n <\/td>\n<\/tr>\n
\n author<\/a><\/code>\n <\/td>\n\n The ID for the author of the template.\n <\/td>\n<\/tr>\n<\/table><\/div>\n
\n

Definition<\/h3>\n

POST \/wp\/v2\/templates\/<id>\/autosaves<\/code>\n <\/div>\n<\/section>\n

\n
\n

Retrieve a Template Revision<\/h2>\n

Definition & Example Request<\/h3>\n

GET \/wp\/v2\/templates\/<parent>\/autosaves\/<id><\/code><\/p>\n

Query this endpoint to retrieve a specific template revision record.<\/p>\n

$ curl https:\/\/example.com\/wp-json\/wp\/v2\/templates\/<parent>\/autosaves\/<id><\/code>\n <\/div>\n

\n

Arguments<\/h3>\n\n\n\n\n
\n parent<\/code>\n <\/td>\n\n The ID for the parent of the autosave.\n <\/td>\n<\/tr>\n
\n id<\/code>\n <\/td>\n\n The ID for the autosave.\n <\/td>\n<\/tr>\n
\n context<\/code>\n <\/td>\n\n Scope under which the request is made; determines fields present in response.<\/p>\n

\n Default: view<\/code>\n <\/p>\n

One of: view<\/code>, embed<\/code>, edit<\/code>\n <\/td>\n<\/tr>\n<\/table><\/div>\n<\/section>\n<\/div>\n","protected":false},"author":0,"featured_media":0,"parent":23078,"menu_order":0,"template":"","meta":{"footnotes":""},"class_list":["post-147376","rest-api-handbook","type-rest-api-handbook","status-publish","hentry","type-handbook"],"revision_note":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/rest-api-handbook\/147376","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/rest-api-handbook"}],"about":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/types\/rest-api-handbook"}],"version-history":[{"count":3,"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/rest-api-handbook\/147376\/revisions"}],"predecessor-version":[{"id":151968,"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/rest-api-handbook\/147376\/revisions\/151968"}],"up":[{"embeddable":true,"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/rest-api-handbook\/23078"}],"wp:attachment":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/media?parent=147376"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}