Schema #Schema The schema defines all the fields that exist for a attachment object. date string, datetime (ISO8601) The date the object was published, in the site’s timezone. Context: view, edit, embed date_gmt string, datetime (ISO8601) 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 link string, uri URL to the object. Read only Context: view, edit, embed modified string, datetime (ISO8601) The date the object was last modified, in the site’s timezone. Read only Context: view, edit modified_gmt string, datetime (ISO8601) 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: edit One of: publish, future, draft, pending, private type string Type of Post for the object. Read only Context: view, edit, embed 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 alt_text string Alternative text to display when resource is not displayed. Context: view, edit, embed caption string The caption for the resource. Context: view, edit description string The description for the resource. Context: view, edit media_type string Type of resource. Read only Context: view, edit, embed One of: image, file mime_type string MIME type of resource. Read only Context: view, edit, embed media_details object Details about the resource file, specific to its type. Read only Context: view, edit, embed post integer The id for the associated post of the resource. Context: view, edit source_url string, uri URL to the original resource file. Read only Context: view, edit, embed Example Request #Example Request $ curl -X OPTIONS -i http://demo.wp-api.org/wp-json/wp/v2/media Top ↑ List Media #List Media Top ↑ Arguments #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 resources published after a given ISO8601 compliant date. author Limit result set to posts assigned to specific authors. Default: author_exclude Ensure result set excludes posts assigned to specific authors. Default: before Limit response to resources published before a given ISO8601 compliant date. exclude Ensure result set excludes specific ids. Default: include Limit result set to specific ids. Default: 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: date, relevance, id, include, title, slug parent Limit result set to those of particular parent ids. Default: parent_exclude Limit result set to all items except those of a particular parent id. Default: slug Limit result set to posts with a specific slug. status Limit result set to posts assigned a specific status; can be comma-delimited list of status types. Default: inherit One of: inherit, private, trash filter Use WP Query arguments to modify the response; private query vars require appropriate authorization. media_type Limit result set to attachments of a particular media type. One of: image, video, audio, application mime_type Limit result set to attachments of a particular MIME type. Top ↑ Definition #Definition GET /wp/v2/media Example Request #Example Request $ curl http://demo.wp-api.org/wp-json/wp/v2/media Top ↑ Retrieve a Media Item #Retrieve a Media Item Top ↑ Arguments #Arguments context Scope under which the request is made; determines fields present in response. Default: view One of: view, embed, edit password The password for the post if it is password protected. Top ↑ Definition #Definition GET /wp/v2/media/<id> Example Request #Example Request $ curl http://demo.wp-api.org/wp-json/wp/v2/media/<id> Top ↑ Create Media #Create Media Top ↑ Arguments #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. alt_text Alternative text to display when resource is not displayed. caption The caption for the resource. description The description for the resource. post The id for the associated post of the resource. Top ↑ Definition #Definition POST /wp/v2/media Top ↑ Update Media #Update Media Top ↑ Arguments #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. alt_text Alternative text to display when resource is not displayed. caption The caption for the resource. description The description for the resource. post The id for the associated post of the resource. Top ↑ Definition #Definition POST /wp/v2/media/<id> Example Request #Example Request Top ↑ Delete Media #Delete Media Top ↑ Arguments #Arguments force Whether to bypass trash and force deletion. Top ↑ Definition #Definition DELETE /wp/v2/media/<id> Example Request #Example Request $ curl -X DELETE http://demo.wp-api.org/wp-json/wp/v2/media/<id>