Automattic

Automattic Media API

The media API from Automattic — 14 operation(s) for media.

GitHub OpenAPI

Operations 26

GET /sites/{site}/media/ Get a list of items in the media library #
POST /sites/{site}/media/new Upload a new piece of media #
GET /sites/{site}/media/{media_ID} Get a single media item (by ID) #
POST /sites/{site}/media/{media_ID} Edit basic information about a media item #
POST /sites/{site}/media/{media_ID}/delete Delete a piece of media. Note: Media is deleted and not trashed #
POST /sites/{site}/media/{media_ID}/edit Edit a media item #
GET /wp/v2/sites/{wpcom_site}/media GET /wp/v2/sites/{wpcom_site}/media #
POST /wp/v2/sites/{wpcom_site}/media POST /wp/v2/sites/{wpcom_site}/media #
GET /wp/v2/sites/{wpcom_site}/media/{id} GET /wp/v2/sites/{wpcom_site}/media/{id} #
POST /wp/v2/sites/{wpcom_site}/media/{id} POST /wp/v2/sites/{wpcom_site}/media/{id} #
PUT /wp/v2/sites/{wpcom_site}/media/{id} PUT /wp/v2/sites/{wpcom_site}/media/{id} #
PATCH /wp/v2/sites/{wpcom_site}/media/{id} PATCH /wp/v2/sites/{wpcom_site}/media/{id} #
DELETE /wp/v2/sites/{wpcom_site}/media/{id} DELETE /wp/v2/sites/{wpcom_site}/media/{id} #
POST /wp/v2/sites/{wpcom_site}/media/{id}/edit POST /wp/v2/sites/{wpcom_site}/media/{id}/edit #
POST /wp/v2/sites/{wpcom_site}/media/{id}/finalize POST /wp/v2/sites/{wpcom_site}/media/{id}/finalize #
POST /wp/v2/sites/{wpcom_site}/media/{id}/post-process POST /wp/v2/sites/{wpcom_site}/media/{id}/post-process #
POST /wp/v2/sites/{wpcom_site}/media/{id}/sideload POST /wp/v2/sites/{wpcom_site}/media/{id}/sideload #
POST /wpcom/v2/sites/{wpcom_site}/media/videopress-playback-jwt/{guid} POST /wpcom/v2/sites/{wpcom_site}/media/videopress-playback-jwt/{guid} #
PUT /wpcom/v2/sites/{wpcom_site}/media/videopress-playback-jwt/{guid} PUT /wpcom/v2/sites/{wpcom_site}/media/videopress-playback-jwt/{guid} #
PATCH /wpcom/v2/sites/{wpcom_site}/media/videopress-playback-jwt/{guid} PATCH /wpcom/v2/sites/{wpcom_site}/media/videopress-playback-jwt/{guid} #
POST /wpcom/v2/sites/{wpcom_site}/media/videopress-privacy-details/{guid} POST /wpcom/v2/sites/{wpcom_site}/media/videopress-privacy-details/{guid} #
PUT /wpcom/v2/sites/{wpcom_site}/media/videopress-privacy-details/{guid} PUT /wpcom/v2/sites/{wpcom_site}/media/videopress-privacy-details/{guid} #
PATCH /wpcom/v2/sites/{wpcom_site}/media/videopress-privacy-details/{guid} PATCH /wpcom/v2/sites/{wpcom_site}/media/videopress-privacy-details/{guid} #
POST /wpcom/v2/sites/{wpcom_site}/media/videopress-upload-jwt POST /wpcom/v2/sites/{wpcom_site}/media/videopress-upload-jwt #
PUT /wpcom/v2/sites/{wpcom_site}/media/videopress-upload-jwt PUT /wpcom/v2/sites/{wpcom_site}/media/videopress-upload-jwt #
PATCH /wpcom/v2/sites/{wpcom_site}/media/videopress-upload-jwt PATCH /wpcom/v2/sites/{wpcom_site}/media/videopress-upload-jwt #

Documentation

📖
Documentation
https://developer.wordpress.com/docs/api/
📖
APIReference
https://developer.wordpress.com/docs/api/rest-api-reference/
📖
GettingStarted
https://developer.wordpress.com/docs/api/getting-started/
📖
Documentation
https://akismet.com/development/api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/openapi/automattic-media-api-openapi.yml

Other Resources

🔗
Console
https://developer.wordpress.com/docs/api/console/
🔗
SourceCode
https://github.com/Automattic/akismet-api
🔗
PluginManifest
https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/well-known/automattic-ai-plugin.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/automattic-media-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

automattic-media-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Automattic Media API
  x-derived-by: API Evangelist enrichment pipeline
  x-refined-note:
  - x-derived-from differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged media across 4 of this provider''s published API definitions: automattic-wordpress-com-rest-v1-1-openapi.yml, automattic-wordpress-com-rest-v1-2-openapi.yml, automattic-wordpress-com-wp-v2-openapi.yml, automattic-wordpress-com-wpcom-v2-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://public-api.wordpress.com/rest/v1.1
- url: https://public-api.wordpress.com/rest/v1.2
- url: https://public-api.wordpress.com
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (78 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/openapi/automattic-media-api-openapi.yml