The WordPress core REST API shape as served by WordPress.com, site-scoped at /wp/v2/sites/{site}/. 348 operations across posts, pages, comments, media, taxonomies, block types, block patterns, global styles, templates, plugins, themes, settings and the WordPress Abilities API. Chosen when portability with self-hosted WordPress matters.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/wordpresscom-rest-api-wpv2-namespace"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.1.0
info:
title: WordPress.com REST API — wp/v2 namespace
version: v2
description: Derived by API Evangelist from the WordPress.com REST API route index published at https://public-api.wordpress.com/wp/v2/.
Paths, HTTP methods, and parameter names/types/descriptions/defaults are taken verbatim from that
index. Response schemas are not published in the route index, so successful responses are described
but not schematised; the error envelope was observed live on public-api.wordpress.com.
contact:
name: Automattic
url: https://developer.wordpress.com/docs/api/
x-derived-from: https://public-api.wordpress.com/wp/v2/
x-derived-by: API Evangelist enrichment pipeline
servers:
- url: https://public-api.wordpress.com
tags:
- name: abilities
- name: activity-log-events
- name: akismet
- name: block-directory
- name: block-patterns
- name: block-renderer
- name: block-types
- name: blocks
- name: categories
- name: comments
- name: feedback
- name: font-collections
- name: font-families
- name: global-styles
- name: guidelines
- name: icon-collections
- name: icons
- name: jetpack-forms
- name: jetpack-global-styles
- name: jp_pay_order
- name: jp_pay_product
- name: knowledge
- name: media
- name: menu-items
- name: menu-locations
- name: menus
- name: navigation
- name: pages
- name: pattern-directory
- name: plugins
- name: posts
- name: search
- name: settings
- name: sidebars
- name: statuses
- name: tags
- name: taxonomies
- name: template-parts
- name: templates
- name: themes
- name: types
- name: users
- name: view-config
- name: widget-types
- name: widgets
- name: wp-abilities
- name: wp-v2
- name: wp_guideline_type
- name: wp_knowledge_type
- name: wp_pattern_category
paths:
/wp/v2:
get:
operationId: getWpV2
summary: GET /wp/v2
tags:
- wp-v2
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: namespace
in: query
required: false
schema:
default: wp/v2
- name: context
in: query
required: false
schema:
default: view
/wp/v2/abilities/{name}/run:
get:
operationId: getWpV2AbilitiesbyNameRun
summary: GET /wp/v2/abilities/{name}/run
tags:
- abilities
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: name
in: path
required: true
schema:
type: string
- name: input
in: query
required: false
schema:
type: string
description: Input parameters for the ability execution.
post:
operationId: postWpV2AbilitiesbyNameRun
summary: POST /wp/v2/abilities/{name}/run
tags:
- abilities
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: name
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
input:
type: string
description: Input parameters for the ability execution.
put:
operationId: putWpV2AbilitiesbyNameRun
summary: PUT /wp/v2/abilities/{name}/run
tags:
- abilities
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: name
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
input:
type: string
description: Input parameters for the ability execution.
patch:
operationId: patchWpV2AbilitiesbyNameRun
summary: PATCH /wp/v2/abilities/{name}/run
tags:
- abilities
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: name
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
input:
type: string
description: Input parameters for the ability execution.
delete:
operationId: deleteWpV2AbilitiesbyNameRun
summary: DELETE /wp/v2/abilities/{name}/run
tags:
- abilities
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: name
in: path
required: true
schema:
type: string
- name: input
in: query
required: false
schema:
type: string
description: Input parameters for the ability execution.
/wp/v2/sites/{wpcom_site}:
get:
operationId: getWpV2SitesbyWpcomSite
summary: GET /wp/v2/sites/{wpcom_site}
tags:
- wp-v2
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
- name: namespace
in: query
required: false
schema:
default: wp/v2
- name: context
in: query
required: false
schema:
default: view
/wp/v2/sites/{wpcom_site}/activity-log-events:
get:
operationId: getWpV2SitesbyWpcomSiteActivityLogEvents
summary: GET /wp/v2/sites/{wpcom_site}/activity-log-events
tags:
- activity-log-events
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
- name: context
in: query
required: false
schema:
type: string
enum:
- view
- embed
- edit
default: view
description: Scope under which the request is made; determines fields present in response.
- name: page
in: query
required: false
schema:
type: integer
default: 1
description: Current page of the collection.
- name: per_page
in: query
required: false
schema:
type: integer
default: 10
description: Maximum number of items to be returned in result set.
- name: search
in: query
required: false
schema:
type: string
description: Limit results to those matching a string.
- name: after
in: query
required: false
schema:
type: string
format: date-time
description: Limit response to posts published after a given ISO8601 compliant date.
- name: modified_after
in: query
required: false
schema:
type: string
format: date-time
description: Limit response to posts modified after a given ISO8601 compliant date.
- name: before
in: query
required: false
schema:
type: string
format: date-time
description: Limit response to posts published before a given ISO8601 compliant date.
- name: modified_before
in: query
required: false
schema:
type: string
format: date-time
description: Limit response to posts modified before a given ISO8601 compliant date.
- name: exclude
in: query
required: false
schema:
type: array
default: []
items:
type: integer
description: Ensure result set excludes specific IDs.
- name: include
in: query
required: false
schema:
type: array
default: []
items:
type: integer
description: Limit result set to specific IDs.
- name: search_semantics
in: query
required: false
schema:
type: string
enum:
- exact
description: How to interpret the search input.
- name: offset
in: query
required: false
schema:
type: integer
description: Offset the result set by a specific number of items.
- name: order
in: query
required: false
schema:
type: string
enum:
- asc
- desc
default: desc
description: Order sort attribute ascending or descending.
- name: orderby
in: query
required: false
schema:
type: string
enum:
- author
- date
- id
- include
- modified
- parent
- relevance
- slug
- include_slugs
- title
default: date
description: Sort collection by post attribute.
- name: search_columns
in: query
required: false
schema:
type: array
default: []
items:
type: string
description: Array of column names to be searched.
- name: slug
in: query
required: false
schema:
type: array
items:
type: string
description: Limit result set to posts with one or more specific slugs.
- name: status
in: query
required: false
schema:
type: array
default: publish
items:
type: string
description: Limit result set to posts assigned one or more statuses.
post:
operationId: postWpV2SitesbyWpcomSiteActivityLogEvents
summary: POST /wp/v2/sites/{wpcom_site}/activity-log-events
tags:
- activity-log-events
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
date:
type: string
format: date-time
description: The date the post was published, in the site's timezone.
date_gmt:
type: string
format: date-time
description: The date the post was published, as GMT.
slug:
type: string
description: An alphanumeric identifier for the post unique to its type.
status:
type: string
enum:
- publish
- future
- draft
- pending
- private
- spam
description: A named status for the post.
password:
type: string
description: A password to protect access to the content and excerpt.
title:
type: object
description: The title for the post.
content:
type: object
description: The content for the post.
template:
type: string
description: The theme file to use to display the post.
/wp/v2/sites/{wpcom_site}/activity-log-events/{id}:
get:
operationId: getWpV2SitesbyWpcomSiteActivityLogEventsbyId
summary: GET /wp/v2/sites/{wpcom_site}/activity-log-events/{id}
tags:
- activity-log-events
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
- name: context
in: query
required: false
schema:
type: string
enum:
- view
- embed
- edit
default: view
description: Scope under which the request is made; determines fields present in response.
- name: password
in: query
required: false
schema:
type: string
description: The password for the post if it is password protected.
post:
operationId: postWpV2SitesbyWpcomSiteActivityLogEventsbyId
summary: POST /wp/v2/sites/{wpcom_site}/activity-log-events/{id}
tags:
- activity-log-events
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
date:
type: string
format: date-time
description: The date the post was published, in the site's timezone.
date_gmt:
type: string
format: date-time
description: The date the post was published, as GMT.
slug:
type: string
description: An alphanumeric identifier for the post unique to its type.
status:
type: string
enum: &id001
- publish
- future
- draft
- pending
- private
- spam
description: A named status for the post.
password:
type: string
description: A password to protect access to the content and excerpt.
title:
type: object
description: The title for the post.
content:
type: object
description: The content for the post.
template:
type: string
description: The theme file to use to display the post.
put:
operationId: putWpV2SitesbyWpcomSiteActivityLogEventsbyId
summary: PUT /wp/v2/sites/{wpcom_site}/activity-log-events/{id}
tags:
- activity-log-events
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
date:
type: string
format: date-time
description: The date the post was published, in the site's timezone.
date_gmt:
type: string
format: date-time
description: The date the post was published, as GMT.
slug:
type: string
description: An alphanumeric identifier for the post unique to its type.
status:
type: string
enum: *id001
description: A named status for the post.
password:
type: string
description: A password to protect access to the content and excerpt.
title:
type: object
description: The title for the post.
content:
type: object
description: The content for the post.
template:
type: string
description: The theme file to use to display the post.
patch:
operationId: patchWpV2SitesbyWpcomSiteActivityLogEventsbyId
summary: PATCH /wp/v2/sites/{wpcom_site}/activity-log-events/{id}
tags:
- activity-log-events
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
date:
type: string
format: date-time
description: The date the post was published, in the site's timezone.
date_gmt:
type: string
format: date-time
description: The date the post was published, as GMT.
slug:
type: string
description: An alphanumeric identifier for the post unique to its type.
status:
type: string
enum: *id001
description: A named status for the post.
password:
type: string
description: A password to protect access to the content and excerpt.
title:
type: object
description: The title for the post.
content:
type: object
description: The content for the post.
template:
type: string
description: The theme file to use to display the post.
delete:
operationId: deleteWpV2SitesbyWpcomSiteActivityLogEventsbyId
summary: DELETE /wp/v2/sites/{wpcom_site}/activity-log-events/{id}
tags:
- activity-log-events
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
- name: force
in: query
required: false
schema:
type: boolean
default: false
description: Whether to bypass Trash and force deletion.
/wp/v2/sites/{wpcom_site}/activity-log-events/{id}/autosaves:
get:
operationId: getWpV2SitesbyWpcomSiteActivityLogEventsbyIdAutosaves
summary: GET /wp/v2/sites/{wpcom_site}/activity-log-events/{id}/autosaves
tags:
- activity-log-events
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
- name: parent
in: query
required: false
schema:
type: integer
description: The ID for the parent of the autosave.
- name: context
in: query
required: false
schema:
type: string
enum:
- view
- embed
- edit
default: view
description: Scope under which the request is made; determines fields present in response.
post:
operationId: postWpV2SitesbyWpcomSiteActivityLogEventsbyIdAutosaves
summary: POST /wp/v2/sites/{wpcom_site}/activity-log-events/{id}/autosaves
tags:
- activity-log-events
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
parent:
type: integer
description: The ID for the parent of the autosave.
date:
type: string
format: date-time
description: The date the post was published, in the site's timezone.
date_gmt:
type: string
format: date-time
description: The date the post was published, as GMT.
slug:
type: string
description: An alphanumeric identifier for the post unique to its type.
status:
type: string
enum:
- publish
- future
- draft
- pending
- private
- spam
description: A named status for the post.
password:
type: string
description: A password to protect access to the content and excerpt.
title:
type: object
description: The title for the post.
content:
type: object
description: The content for the post.
template:
type: string
description: The theme file to use to display the post.
/wp/v2/sites/{wpcom_site}/activity-log-events/{parent}/autosaves/{id}:
get:
operationId: getWpV2SitesbyWpcomSiteActivityLogEventsbyParentAutosavesbyId
summary: GET /wp/v2/sites/{wpcom_site}/activity-log-events/{parent}/autosaves/{id}
tags:
- activity-log-events
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
- name: parent
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
- name: context
in: query
required: false
schema:
type: string
enum:
- view
- embed
- edit
default: view
description: Scope under which the request is made; determines fields present in response.
/wp/v2/sites/{wpcom_site}/akismet/v1/webhook:
post:
operationId: postWpV2SitesbyWpcomSiteAkismetV1Webhook
summary: POST /wp/v2/sites/{wpcom_site}/akismet/v1/webhook
tags:
- akismet
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
/wp/v2/sites/{wpcom_site}/block-directory/search:
get:
operationId: getWpV2SitesbyWpcomSiteBlockDirectorySearch
summary: GET /wp/v2/sites/{wpcom_site}/block-directory/search
tags:
- block-directory
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
- name: context
in: query
required: false
schema:
type: string
enum:
- view
default: view
description: Scope under which the request is made; determines fields present in response.
- name: page
in: query
required: false
schema:
type: integer
default: 1
description: Current page of the collection.
- name: per_page
in: query
required: false
schema:
type: integer
default: 10
description: Maximum number of items to be returned in result set.
- name: term
in: query
required: true
schema:
type: string
description: Limit result set to blocks matching the search term.
/wp/v2/sites/{wpcom_site}/block-patterns/categories:
get:
operationId: getWpV2SitesbyWpcomSiteBlockPatternsCategories
summary: GET /wp/v2/sites/{wpcom_site}/block-patterns/categories
tags:
- block-patterns
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
/wp/v2/sites/{wpcom_site}/block-patterns/patterns:
get:
operationId: getWpV2SitesbyWpcomSiteBlockPatternsPatterns
summary: GET /wp/v2/sites/{wpcom_site}/block-patterns/patterns
tags:
- block-patterns
responses:
'200':
description: OK
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/WPRestError'
parameters:
- name: wpcom_site
in: path
required: true
schema:
type: string
/wp/v2/sites/{wpcom_site}/block-renderer/{name}:
get:
operationId: getWpV2SitesbyWpcomSiteBlockRendererbyName
summary: GET /wp/v2/sites/{wpcom_site}/block-renderer/{name}
# --- truncated at 32 KB (652 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/openapi/automattic-wordpress-com-wp-v2-openapi.yml