Wp Rest Api

What it does

This skill assists with developing and debugging WordPress REST API integrations. It enables AI agents to create, update, and troubleshoot REST routes/endpoints within a WordPress environment. The skill focuses on tasks like adding custom fields to responses, exposing custom post types, implementing data validation, and adjusting pagination settings for APIs.

When to use it

• Creating or updating REST endpoints in a WordPress project.
• Debugging common REST API errors such as 401, 403, or 404 issues, including permission and nonce problems.
• Adding custom fields or metadata to the data returned by REST API responses.
• Exposing custom post types or taxonomies through the WordPress REST API.
• Adjusting response links, embedding options, or pagination behavior for APIs.

Key capabilities

• Creating and updating REST routes using register_rest_route().
• Implementing schema and argument validation.
• Adding custom fields/meta to REST responses using register_rest_field and register_meta.
• Exposing custom post types or taxonomies via the WordPress REST API (using show_in_rest).
• Adjusting response links with WP_REST_Response::add_link().

Example prompts

• "Create a new REST endpoint under the 'my-plugin/v1' namespace to retrieve user data."
• "Debug why I am receiving a 403 error when accessing my custom REST route."
• "Add a custom field called 'featured_image_url' to the response for posts accessed via the /wp/v2/posts endpoint."

Tips & gotchas

• The skill requires knowledge of WordPress development and REST API principles.
• When working with full site repositories, ensure you are modifying code within the correct plugin or theme.
• Always use a unique namespace (e.g., vendor/v1) for custom endpoints to avoid conflicts.