Post Toolswordpress_read_post

wordpress_read_post

Read a WordPress post, including its content and metadata.

wordpress_read_post

Get full content of a specific post.

Parameters

2 parameters, 1 required.

NameTypeRequiredWhat it is
idnumberyesPost ID
includestringnoOptional v2 include CSV

Example call

The smallest valid call, with the required parameters only:

{
  "name": "wordpress_read_post",
  "arguments": {
    "id": 123
  }
}

Response

{
  "success": true,
  "id": 101,
  "title": "Hello World",
  "status": "publish",
  "content": "<p>...</p>",
  "meta": {}
}

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_wrong_post_type: The ID belongs to a different post type than this tool works on. Use the matching tool, for example the custom post tools for a custom post type.
  • respira_post_not_found: No post or page has that ID. List the pages or posts and take the 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.
  • respira_scope_denied: The connection is read-only, and this call would write. Use a connection with write access, or switch the site out of read-only in Respira settings.

How long it takes

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

  • "Read post 101"
  • "Show me the content of my latest blog post"
Was this page helpful?