Custom Post Type Toolswordpress_get_custom_post

wordpress_get_custom_post

Get a custom post by type and ID.

wordpress_get_custom_post

Get custom post details.

Parameters

3 parameters, 2 required.

NameTypeRequiredWhat it is
typestringyesPost type name
idnumberyesPost ID
includestringnoOptional v2 include CSV

Example call

The smallest valid call, with the required parameters only:

{
  "name": "wordpress_get_custom_post",
  "arguments": {
    "type": "value",
    "id": 123
  }
}

Response

{
  "success": true,
  "type": "product",
  "id": 3001,
  "title": "Product A",
  "status": "publish",
  "content": "<p>...</p>"
}

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_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.
  • respira_unknown_include: The include parameter asked for a part this tool does not return. The error lists the supported values. Use those.
  • respira_post_not_found: No post or page has that ID. List the pages or posts and take the ID from the result.
  • 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 1.5 seconds. 19 in 20 finish within 3.6 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

  • "Get product 3001"
  • "Read custom post type 'portfolio' with ID 42"
Was this page helpful?