Post Revisions 
Edit
Topics
Schema Schema
The schema defines all the fields that exist within a post 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.
authorinteger |
The ID for the author of the object.
Context: |
datestring, datetime ([details](https://core.trac.wordpress.org/ticket/41032)) |
The date the object was published, in the site's timezone.
Context: |
date_gmtstring, datetime ([details](https://core.trac.wordpress.org/ticket/41032)) |
The date the object was published, as GMT.
Context: |
guidobject |
The globally unique identifier for the object.
Read only Context: |
idinteger |
Unique identifier for the object.
Context: |
modifiedstring, datetime ([details](https://core.trac.wordpress.org/ticket/41032)) |
The date the object was last modified, in the site's timezone.
Context: |
modified_gmtstring, datetime ([details](https://core.trac.wordpress.org/ticket/41032)) |
The date the object was last modified, as GMT.
Context: |
parentinteger |
The ID for the parent of the object.
Context: |
slugstring |
An alphanumeric identifier for the object unique to its type.
Context: |
titleobject |
The title for the object.
Context: |
contentobject |
The content for the object.
Context: |
excerptobject |
The excerpt for the object.
Context: |
List Post Revisions List Post Revisions
Query this endpoint to retrieve a collection of post revisions. The response you receive can be controlled and filtered using the URL query parameters below.
Definition Definition
GET /wp/v2/posts/<parent>/revisions
Example Request Example Request
$ curl https://example.com/wp-json/wp/v2/posts/<parent>/revisions
Arguments Arguments
parent
|
The ID for the parent of the object. |
context
|
Scope under which the request is made; determines fields present in response.
Default: One of: |
page
|
Current page of the collection.
Default: |
per_page
|
Maximum number of items to be returned in result set. |
search
|
Limit results to those matching a string. |
exclude
|
Ensure result set excludes specific IDs. |
include
|
Limit result set to specific IDs. |
offset
|
Offset the result set by a specific number of items. |
order
|
Order sort attribute ascending or descending.
Default: One of: |
orderby
|
Sort collection by object attribute.
Default: One of: |
Retrieve a Post Revision Retrieve a Post Revision
Definition & Example Request Definition & Example Request
GET /wp/v2/posts/<parent>/revisions/<id>
Query this endpoint to retrieve a specific post revision record.
$ curl https://example.com/wp-json/wp/v2/posts/<parent>/revisions/<id>
Delete a Post Revision Delete a Post Revision
Arguments Arguments
parent
|
The ID for the parent of the object. |
id
|
Unique identifier for the object. |
force
|
Required to be true, as revisions do not support trashing. |
Definition Definition
DELETE /wp/v2/posts/<parent>/revisions/<id>
Example Request Example Request
$ curl -X DELETE https://example.com/wp-json/wp/v2/posts/<parent>/revisions/<id>
Retrieve a Post Revision Retrieve a Post Revision
Definition & Example Request Definition & Example Request
GET /wp/v2/posts/<id>/autosaves
Query this endpoint to retrieve a specific post revision record.
$ curl https://example.com/wp-json/wp/v2/posts/<id>/autosaves
Create a Post Revision Create a Post Revision
Arguments Arguments
parent
|
The ID for the parent of the object. |
date
|
The date the object was published, in the site's timezone. |
date_gmt
|
The date the object was published, as GMT. |
slug
|
An alphanumeric identifier for the object unique to its type. |
status
|
A named status for the object. One of: publish, future, draft, pending, private
|
password
|
A password to protect access to the content and excerpt. |
title
|
The title for the object. |
content
|
The content for the object. |
author
|
The ID for the author of the object. |
excerpt
|
The excerpt for the object. |
featured_media
|
The ID of the featured media for the object. |
comment_status
|
Whether or not comments are open on the object. One of: open, closed
|
ping_status
|
Whether or not the object can be pinged. One of: open, closed
|
format
|
The format for the object. One of: standard, aside, chat, gallery, link, image, quote, status, video, audio
|
meta
|
Meta fields. |
sticky
|
Whether or not the object should be treated as sticky. |
template
|
The theme file to use to display the object. |
categories
|
The terms assigned to the object in the category taxonomy. |
tags
|
The terms assigned to the object in the post_tag taxonomy. |
Retrieve a Post Revision Retrieve a Post Revision
Definition & Example Request Definition & Example Request
GET /wp/v2/posts/<parent>/autosaves/<id>
Query this endpoint to retrieve a specific post revision record.
$ curl https://example.com/wp-json/wp/v2/posts/<parent>/autosaves/<id>