playground.wordpress.net

playground_request

Make an HTTP request to the WordPress site running in Playground. REST API requests (/wp-json/* or ?rest_route=) are automatically authenticated with a valid nonce — no manual auth needed. Tool selection guide: 1. Use this tool (playground_request) with the REST API for standard content CRUD — posts, pages, users, terms, comments, settings, etc. The REST API handles serialization, pagination, and field filtering for you. Prefer compact REST responses: use _fields to request only the fields needed and per_page/page for large collections. Before using endpoint-specific filters, inspect the route metadata from /wp-json/ and use only args documented for that route. 2. Use this tool with the WordPress REST API to discover and call registered abilities when the site exposes the Abilities API: - GET /wp-json/wp-abilities/v1/abilities lists registered abilities. Always assume this response may be large and start with _fields, e.g. /wp-json/wp-abilities/v1/abilities?_fields=name,category,label,description Do not assume filters like search or category exist unless /wp-json/ route metadata documents them. - GET /wp-json/wp-abilities/v1/abilities/{name} gets one ability, including schemas and metadata. Ability names include "/" in the path; do not encode it. For example, use /wp-json/wp-abilities/v1/abilities/memex/save-note for "memex/save-note". - GET, POST, or DELETE /wp-json/wp-abilities/v1/abilities/{name}/run executes the ability. Inspect the ability metadata first, then call /run with the documented method. POST bodies usually wrap arguments in an "input" object, e.g. {"input":{"title":"Hello"}}. - GET /wp-json/wp-abilities/v1/categories lists ability categories. Each category includes _links.abilities; follow that URL to list abilities in that category. The abilities collection can also be filtered directly with /wp-json/wp-abilities/v1/abilities?category={slug}. 3. Use playground_execute_php when the data you need is not exposed by the REST API (e.g. raw options, dire…

Input schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Request URL path, e.g.\n\t\t\t\t\t\"/wp-json/wp/v2/posts\" or\n\t\t\t\t\t\"/wp-admin/plugins.php\""
    },
    "method": {
      "type": "string",
      "description": "HTTP method (GET, POST, PUT,\n\t\t\t\t\tDELETE, etc.). Defaults to GET.",
      "default": "GET"
    },
    "headers": {
      "type": "object",
      "description": "Request headers as string key-value\n\t\t\t\t\tpairs, e.g. {\"Content-Type\":\n\t\t\t\t\t\"application/json\"}",
      "additionalProperties": true
    },
    "body": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "object"
        }
      ],
      "description": "Request body (for POST/PUT requests).\n\t\t\t\t\tAccepts a JSON string or an object."
    }
  },
  "required": [
    "url"
  ]
}