Skip to content

Supported WordPress REST APIs

This page documents the WordPress REST API endpoints supported by this client.

The complete WordPress REST API reference is available in the official WordPress documentation: https://developer.wordpress.org/rest-api/reference/.


Tested WordPress Versions

The supported APIs are covered by integration tests in the wp-rest-client-test-integration module and are continuously validated against the following WordPress versions:

WordPress Version Tested
6.3.x ✅
6.4.x ✅
6.5.x ✅
6.6.x ✅
6.7.x ✅
6.8.x ✅
7.0.x ✅
7.1.x ✅

Integration tests are executed against all supported WordPress versions to help ensure API compatibility and detect regressions across releases.


APIs

Resource Endpoint Read Create Update Delete Notes
Posts /posts ✅ ✅ ✅ ✅ Blog posts and post content.
Post Revisions /posts/<parent>/revisions ✅ N/A N/A N/A Blog posts revisions.
Pages /pages ✅ ✅ ✅ ✅ Static site pages.
Page Revisions /pages/<parent>/revisions ✅ N/A N/A N/A Static site pages revisions.
Media /media ✅ ✅ ✅ ✅ Images, files, and attachments.
Categories /categories ✅ ✅ ✅ ✅ Post categories.
Tags /tags ✅ ✅ ✅ ✅ Post tags.
Comments /comments ✅ ✅ ✅ ✅ Comments and moderation workflows.
Users /users 🚫 🚫 🚫 🚫 Usually requires authentication.
Search /search ✅ N/A N/A N/A Search across public content.
Taxonomies /taxonomies ✅ N/A N/A N/A Taxonomy metadata.
Post Types /types ✅ N/A N/A N/A Registered post type metadata.
Statuses /statuses ✅ N/A N/A N/A Registered post statuses.
Settings /settings 🚫 N/A 🚫 N/A Requires elevated permissions.

Legend:

  • ✅ supported
  • ⬜ not implemented yet
  • 🚫 not planned
  • N/A not applicable

Posts

Endpoint Description Status
GET /wp/v2/posts List Posts ✅
POST /wp/v2/posts Create a Post ✅
GET /wp/v2/posts/<id> Retrieve a Post ✅
POST /wp/v2/posts/<id> Update a Post ✅
DELETE /wp/v2/posts/<id> Delete a Post ✅

Post Revisions

Endpoint Description Status Notes
GET /wp/v2/posts/<parent>/revisions List Posts Revisions ✅
GET /wp/v2/posts/<parent>/revisions/<id> Retrieve a Post Revision ✅
DELETE /wp/v2/posts/<parent>/revisions/<id> Delete a Post Revision N/A Although the deletion is mentioned in the reference page, WordPress actually does not allow the deletion via REST API

Pages

Endpoint Description Status
GET /wp/v2/pages List Pages ✅
POST /wp/v2/pages Create a Page ✅
GET /wp/v2/pages/<id> Retrieve a Page ✅
POST /wp/v2/pages/<id> Update a Page ✅
DELETE /wp/v2/pages/<id> Delete a Page ✅

Page Revisions

Endpoint Description Status Notes
GET /wp/v2/pages/<parent>/revisions List Page Revisions ✅
GET /wp/v2/pages/<parent>/revisions/<id> Retrieve a Page Revision ✅
DELETE /wp/v2/pages/<parent>/revisions/<id> Delete a Page Revision N/A Although the deletion is mentioned in the reference page, WordPress actually does not allow the deletion via REST API

Media

Endpoint Description Status
GET /wp/v2/media List Media ✅
POST /wp/v2/media Create a Media item ✅
GET /wp/v2/media/<id> Retrieve a Media item ✅
POST /wp/v2/media/<id> Update a Media item ✅
DELETE /wp/v2/media/<id> Delete a Media item ✅

Categories

Endpoint Description Status
GET /wp/v2/categories List Categories ✅
POST /wp/v2/categories Create a Category ✅
GET /wp/v2/categories/<id> Retrieve a Category ✅
POST /wp/v2/categories/<id> Update a Category ✅
DELETE /wp/v2/categories/<id> Delete a Category ✅

Tags

Endpoint Description Status
GET /wp/v2/tags List Tags ✅
POST /wp/v2/tags Create a Tag ✅
GET /wp/v2/tags/<id> Retrieve a Tag ✅
POST /wp/v2/tags/<id> Update a Tag ✅
DELETE /wp/v2/tags/<id> Delete a Tag ✅

Comments

Endpoint Description Status
GET /wp/v2/comments List Comments ✅
POST /wp/v2/comments Create a Comment ✅
GET /wp/v2/comments/<id> Retrieve a Comment ✅
POST /wp/v2/comments/<id> Update a Comment ✅
DELETE /wp/v2/comments/<id> Delete a Comment ✅

Taxonomies

Endpoint Description Status
GET /wp/v2/taxonomies List Taxonomies ✅
GET /wp/v2/taxonomies/<name> Get Taxonomy ✅

Post Types

Endpoint Description Status
GET /wp/v2/types List Post Types ✅
GET /wp/v2/types/<name> Get Post Type ✅

Statuses

Endpoint Description Status
GET /wp/v2/statuses List Statuses ✅
GET /wp/v2/statuses/<name> Get Status ✅