Media Toolswordpress_list_media

wordpress_list_media

List WordPress media items with optional search and pagination.

wordpress_list_media

List all media files (images, videos, etc.).

Parameters

3 parameters, none required.

NameTypeRequiredWhat it is
searchstringnoSearch term
pagenumbernoPage number
per_pagenumbernoItems per page

Example call

No parameter is required, so the smallest valid call is empty:

{
  "name": "wordpress_list_media",
  "arguments": {}
}

Response

{
  "success": true,
  "media": [
    {
      "id": 501,
      "title": "Hero Image",
      "mimeType": "image/jpeg",
      "sourceUrl": "https://example.com/wp-content/uploads/hero.jpg"
    }
  ]
}

What it changes

Nothing. It only reads, so there is nothing to approve and nothing to undo.

When it fails

The failures seen most often on real sites in the last 30 days, most common first:

  • respira_site_id_not_found: No connected site has that ID. Call respira_list_sites and use an ID from the result.

How long it takes

A typical call takes about 1.9 seconds. 19 in 20 finish within 3.5 seconds. Measured on real sites over the last week, so it includes the site's own hosting.

Availability

Works on any WordPress site, whichever page builder it uses. Available since Respira 1.0.0.

Example Prompts

  • "List my media library"
  • "Search media for 'logo'"
Was this page helpful?