Page Toolswordpress_list_pages

wordpress_list_pages

List WordPress pages with optional filtering and pagination.

wordpress_list_pages

List all pages with optional filtering.

Parameters

5 parameters, none required.

NameTypeRequiredWhat it is
statusstringnoFilter by status (publish, draft, pending)
searchstringnoSearch term
pagenumbernoPage number for pagination
per_pagenumbernoNumber of items per page
includestringnoOptional v2 include CSV (basic, content.rendered, builder.payload, snapshot.current, etc.)

Example call

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

{
  "name": "wordpress_list_pages",
  "arguments": {}
}

Response

{
  "success": true,
  "pages": [
    {
      "id": 2,
      "title": "Home",
      "status": "publish",
      "slug": "home"
    }
  ],
  "page": 1,
  "perPage": 20
}

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_invalid_site_token: The site rejected the token. It was revoked, or the site was reconnected since. Reconnect the site from the Respira dashboard.
  • respira_site_id_not_found: No connected site has that ID. Call respira_list_sites and use an ID from the result.
  • respira_unknown_include: The include parameter asked for a part this tool does not return. The error lists the supported values. Use those.
  • rest_no_route: The WordPress site has no such endpoint. Almost always an old plugin version, or a security plugin blocking the REST API. Update Respira for WordPress on the site and try again.

How long it takes

A typical call takes about 2.2 seconds. 19 in 20 finish within 4.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.

Next Steps

Found a page? Read its full content with wordpress_read_page, then make changes using wordpress_update_page.

For bulk operations across many pages, see the Bulk Content Updates Guide.

Example Prompts

  • "List all pages on my WordPress site"
  • "List draft pages"
  • "Search pages for 'pricing'"
  • "Show me pages 2 at a time"
Was this page helpful?