Comments Edit
Topics
Schema Schema
The schema defines all the fields that exist for a comment object.
id integer |
Unique identifier for the object.
Read only Context: |
author integer |
The ID of the user object, if author was a user.
Context: |
author_email string, |
Email address for the object author.
Context: |
author_ip string, ip |
IP address for the object author.
Context: |
author_name string |
Display name for the object author.
Context: |
author_url string, uri |
URL for the object author.
Context: |
author_user_agent string |
User agent for the object author.
Context: |
content object |
The content for the object.
Context: |
date string, datetime ([details](https://core.trac.wordpress.org/ticket/41032)) |
The date the object was published, in the site's timezone.
Context: |
date_gmt string, datetime ([details](https://core.trac.wordpress.org/ticket/41032)) |
The date the object was published, as GMT.
Context: |
link string, uri |
URL to the object.
Read only Context: |
parent integer |
The ID for the parent of the object.
Context: |
post integer |
The ID of the associated post object.
Context: |
status string |
State of the object.
Context: |
type string |
Type of Comment for the object.
Read only Context: |
author_avatar_urls object |
Avatar URLs for the object author.
Read only Context: |
meta object |
Meta fields.
Context: |
Example Request Example Request
$ curl -X OPTIONS -i http://demo.wp-api.org/wp-json/wp/v2/comments
List Comments List Comments
Arguments Arguments
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.
Default: |
search
|
Limit results to those matching a string. |
after
|
Limit response to comments published after a given ISO8601 compliant date. |
author
|
Limit result set to comments assigned to specific user IDs. Requires authorization. |
author_exclude
|
Ensure result set excludes comments assigned to specific user IDs. Requires authorization. |
author_email
|
Limit result set to that from a specific author email. Requires authorization. |
before
|
Limit response to comments published before a given ISO8601 compliant date. |
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: |
parent
|
Limit result set to comments of specific parent IDs. |
parent_exclude
|
Ensure result set excludes specific parent IDs. |
post
|
Limit result set to comments assigned to specific post IDs. |
status
|
Limit result set to comments assigned a specific status. Requires authorization.
Default: |
type
|
Limit result set to comments assigned a specific type. Requires authorization.
Default: |
password
|
The password for the post if it is password protected. |
Definition Definition
GET /wp/v2/comments
Example Request Example Request
$ curl http://demo.wp-api.org/wp-json/wp/v2/comments
Create a Comment Create a Comment
Arguments Arguments
author
|
The ID of the user object, if author was a user. |
author_email
|
Email address for the object author. |
author_ip
|
IP address for the object author. |
author_name
|
Display name for the object author. |
author_url
|
URL for the object author. |
author_user_agent
|
User agent for the object author. |
content
|
The content for the object. |
date
|
The date the object was published, in the site's timezone. |
date_gmt
|
The date the object was published, as GMT. |
parent
|
The ID for the parent of the object. |
post
|
The ID of the associated post object. |
status
|
State of the object. |
meta
|
Meta fields. |
Retrieve a Comment Retrieve a Comment
Arguments Arguments
id
|
Unique identifier for the object. |
context
|
Scope under which the request is made; determines fields present in response.
Default: One of: |
password
|
The password for the parent post of the comment (if the post is password protected). |
Definition Definition
GET /wp/v2/comments/<id>
Example Request Example Request
$ curl http://demo.wp-api.org/wp-json/wp/v2/comments/<id>
Update a Comment Update a Comment
Arguments Arguments
id
|
Unique identifier for the object. |
author
|
The ID of the user object, if author was a user. |
author_email
|
Email address for the object author. |
author_ip
|
IP address for the object author. |
author_name
|
Display name for the object author. |
author_url
|
URL for the object author. |
author_user_agent
|
User agent for the object author. |
content
|
The content for the object. |
date
|
The date the object was published, in the site's timezone. |
date_gmt
|
The date the object was published, as GMT. |
parent
|
The ID for the parent of the object. |
post
|
The ID of the associated post object. |
status
|
State of the object. |
meta
|
Meta fields. |
Delete a Comment Delete a Comment
Arguments Arguments
id
|
Unique identifier for the object. |
force
|
Whether to bypass trash and force deletion. |
password
|
The password for the parent post of the comment (if the post is password protected). |
Definition Definition
DELETE /wp/v2/comments/<id>
Example Request Example Request
$ curl -X DELETE http://demo.wp-api.org/wp-json/wp/v2/comments/<id>