Media Edit

Schema

The schema defines all the fields that exist within a Media Item 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.

date

string or null,
datetime (details)
The date the object was published, in the site's timezone.

Context: view, edit, embed

date_gmt

string or null,
datetime (details)
The date the object was published, as GMT.

Context: view, edit

guid

object
The globally unique identifier for the object.

Read only

Context: view, edit

id

integer
Unique identifier for the object.

Read only

Context: view, edit, embed

modified

string,
datetime (details)
The date the object was last modified, in the site's timezone.

Read only

Context: view, edit

modified_gmt

string,
datetime (details)
The date the object was last modified, as GMT.

Read only

Context: view, edit

slug

string
An alphanumeric identifier for the object unique to its type.

Context: view, edit, embed

status

string
A named status for the object.

Context: view, edit

One of: publish, future, draft, pending, private

type

string
Type of Post for the object.

Read only

Context: view, edit, embed

generated_slug

string
Slug automatically generated from the object title.

Read only

Context: edit

title

object
The title for the object.

Context: view, edit, embed

author

integer
The ID for the author of the object.

Context: view, edit, embed

comment_status

string
Whether or not comments are open on the object.

Context: view, edit

One of: open, closed

ping_status

string
Whether or not the object can be pinged.

Context: view, edit

One of: open, closed

meta

object
Meta fields.

Context: view, edit

template

string
The theme file to use to display the object.

Context: view, edit

alt_text

string
Alternative text to display when attachment is not displayed.

Context: view, edit, embed

caption

object
The attachment caption.

Context: view, edit, embed

description

object
The attachment description.

Context: view, edit

media_type

string
Attachment type.

Read only

Context: view, edit, embed

One of: image, file

mime_type

string
The attachment MIME type.

Read only

Context: view, edit, embed

media_details

object
Details about the media file, specific to its type.

Read only

Context: view, edit, embed

post

integer
The ID for the associated post of the attachment.

Context: view, edit

source_url

string,
uri
URL to the original attachment file.

Read only

Context: view, edit, embed

missing_image_sizes

array
List of the missing image sizes of the attachment.

Read only

Context: edit

Top ↑

List Media

Query this endpoint to retrieve a collection of media. The response you receive can be controlled and filtered using the URL query parameters below.

Top ↑

Definition

GET /wp/v2/media

Top ↑

Example Request

$ curl https://example.com/wp-json/wp/v2/media

Top ↑

Arguments

context Scope under which the request is made; determines fields present in response.

Default: view

One of: view, embed, edit

page Current page of the collection.

Default: 1

per_page Maximum number of items to be returned in result set.

Default: 10

search Limit results to those matching a string.
after Limit response to posts published after a given ISO8601 compliant date.
author Limit result set to posts assigned to specific authors.
author_exclude Ensure result set excludes posts assigned to specific authors.
before Limit response to posts 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: desc

One of: asc, desc

orderby Sort collection by object attribute.

Default: date

One of: author, date, id, include, modified, parent, relevance, slug, include_slugs, title

parent Limit result set to items with particular parent IDs.
parent_exclude Limit result set to all items except those of a particular parent ID.
slug Limit result set to posts with one or more specific slugs.
status Limit result set to posts assigned one or more statuses.

Default: inherit

media_type Limit result set to attachments of a particular media type.
One of: image, video, text, application, audio
mime_type Limit result set to attachments of a particular MIME type.

Top ↑

Create a Media Item

Top ↑

Arguments

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
title The title for the object.
author The ID for the author of 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
meta Meta fields.
template The theme file to use to display the object.
alt_text Alternative text to display when attachment is not displayed.
caption The attachment caption.
description The attachment description.
post The ID for the associated post of the attachment.

Top ↑

Definition

POST /wp/v2/media

Top ↑

Retrieve a Media Item

Top ↑

Definition & Example Request

GET /wp/v2/media/<id>

Query this endpoint to retrieve a specific Media Item record.

$ curl https://example.com/wp-json/wp/v2/media/<id>

Top ↑

Arguments

id Unique identifier for the object.
context Scope under which the request is made; determines fields present in response.

Default: view

One of: view, embed, edit

Top ↑

Update a Media Item

Top ↑

Arguments

id Unique identifier 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.
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
title The title for the object.
author The ID for the author of 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
meta Meta fields.
template The theme file to use to display the object.
alt_text Alternative text to display when attachment is not displayed.
caption The attachment caption.
description The attachment description.
post The ID for the associated post of the attachment.

Top ↑

Definition

POST /wp/v2/media/<id>

Top ↑

Example Request

Top ↑

Delete a Media Item

Top ↑

Arguments

id Unique identifier for the object.
force Whether to bypass Trash and force deletion.

Top ↑

Definition

DELETE /wp/v2/media/<id>

Top ↑

Example Request

$ curl -X DELETE https://example.com/wp-json/wp/v2/media/<id>