WordPress Toolkit

The WordPress toolkit connects a WordPress site to EKB Platform using an Application Password and lets agents and workflows find and read pages and posts, create and edit content using structured blocks, publish and unpublish pages, manage media, handle taxonomy, and restore revisions. The toolkit runs as the WordPress user configured on the agent and can only perform actions that account is permitted to do.

Prerequisites

A WordPress site running WordPress 5.6 or later on HTTPS.
Permalinks set to anything other than Plain (go to Settings → Permalinks to check).
A WordPress Application Password — not your account password. Go to Users → Profile → Application Passwords, enter a name such as EKB Platform Agent, click Add New Application Password, and copy the generated string immediately. WordPress shows it only once.
Access to an EKB Platform project where you can configure an agent or workflow.

The toolkit runs as the WordPress user configured on the agent. Every person who uses the agent acts as that same WordPress user — choose an account scoped to the job, not your administrator login. Never use your WordPress account password; always use an Application Password. Revoke the Application Password under Users → Profile to immediately cut off agent access.

Setup

Open the agent or workflow in EKB Platform

Open the target agent and choose Toolkits. Add the WordPress toolkit.

Enter the site URL

Enter the Site URL as the site root only — for example https://your-site.com. Do not include /wp-admin, /wp-login.php, or /wp-json.

Configure authentication

Leave Authentication Method set to Application Password. Enter your WordPress username (not the label you gave the Application Password) and paste the generated Application Password credential.

Enable the tools you need

Enable only the tools required for the job. Start with read-only tools: Find Pages, List Pages, Get Page, List Posts, and Get Post.

Test the connection

Save the configuration and run Test Connection first. A successful response shows the connected WordPress username and its capabilities.

Test with a draft

Create one throwaway draft page to confirm write access before working on live content.

Available tools

Find & Read

Tool	Description
Find Pages	Resolves a natural-language page name to page candidates. Always call this before editing a page mentioned by name.
List Pages	Lists pages with optional filters for status, search, parent, and pagination.
Get Page	Returns one page with editable block source content.

Create & Edit

Tool	Description
Create Page	Creates a page. Default status is draft. Pass a `blocks` array for structured Gutenberg content.
Update Page	Full rewrite of a page. Prefer Append Blocks for additive changes.
Append Blocks	Adds new blocks to the end of a page without touching existing content. Recommended for additive edits.

Publish

Tool	Description
Publish Page	Sets a page status to published. Requires `publish_pages` capability on the connected account.
Unpublish Page	Returns a page to draft status. Does not trash or delete the page.
Schedule Page	Sets a page to publish automatically at a future date and time.

Delete & Restore

Tool	Description
Delete Page	Moves a page to trash by default. Set `force: true` only for permanent, irreversible deletion.
Restore Page	Untrashes a page and sets it back to draft by default.

History

Tool	Description
List Revisions	Lists saved revisions for a page.
Get Revision	Returns the raw block content of a specific revision.
Restore Revision	Reads a revision’s content and writes it back onto the page, creating a new revision.

Posts

Tool	Description
List Posts	Lists posts with optional filters for status, search, categories, and tags.
Get Post	Returns one post with editable block source content.
Create Post	Creates a post with optional categories, tags, and featured media. Default status is draft.
Update Post	Updates a post. Supports `expected_modified_gmt` to detect concurrent edits.
Delete Post	Moves a post to trash by default. `force: true` permanently deletes.

Media

Tool	Description
List Media	Lists media library items with optional search and pagination.
Upload Media	Uploads a file by base64 string or URL. Returns the media ID and source URL for use in image blocks.
Delete Media	Permanently deletes a media item. Confirm before calling.

Taxonomy

Tool	Description
List Categories	Lists post categories. Returns category IDs for use in Create Post and Update Post.
List Tags	Lists post tags. Returns tag IDs for use in Create Post and Update Post.
Create Category	Creates a new post category.
Create Tag	Creates a new post tag.

Advanced

Tool	Description
Search	Site-wide search across posts, pages, and terms.
Test Connection	Verifies credentials and returns the connected username and capabilities. Run this first after setup.
Custom API Call	Authenticated request to any WordPress REST route. Bypasses verification and block validation. Use only when no dedicated tool covers the need.

Use cases

Find a page by name, read its current content, append a new FAQ section, and confirm the change was applied.
Draft a new product page with structured Gutenberg blocks, review it, and publish it once approved.
Create a blog post with categories and tags, upload a featured image, and schedule it for a future date.
Restore a page to a previous revision after an edit that introduced a problem.
Search the media library for an existing image before uploading a duplicate.

Troubleshooting

Symptom	Likely cause	Fix
Wall of HTML or themed “Page not found”	The Site URL contains a path such as `/wp-admin`.	Set Site URL to the site root only — `https://your-site.com`.
Every call returns 404 and Site URL is clean	Permalinks are set to Plain, making the REST API unreachable.	Go to Settings → Permalinks and select any option other than Plain.
`401 rest_not_logged_in`	The Username field contains the Application Password label, or an account password was used instead.	Use the WordPress login username and the generated Application Password string. Run Test Connection to confirm.
No Application Passwords section in profile	The site is not on HTTPS, or WordPress is older than 5.6.	Fix the site SSL certificate, or install the WP-API Basic-Auth plugin for HTTP-only development sites.
`rest_cannot_*` permissions error	The connected account’s role does not permit the requested action.	Use an account with the required capabilities — publishing requires `publish_pages`.
TLS or certificate error	A self-signed certificate is in use.	Uncheck Verify TLS certificate on development sites only. Never disable on production.

Get Started!

Offerings

Chat

Agents

Knowledge Base

Workflows

Interfaces

Public Chatbot

Project Settings

My Account

Platform Admin

SDK

General Information

Change Logs

Prerequisites

Setup

Available tools

Find & Read

Create & Edit

Publish

Delete & Restore

History

Posts

Media

Taxonomy

Advanced

Use cases

Troubleshooting

​Prerequisites

​Setup

​Available tools

​Find & Read

​Create & Edit

​Publish

​Delete & Restore

​History

​Posts

​Media

​Taxonomy

​Advanced

​Use cases

​Troubleshooting

Prerequisites

Setup

Available tools

Find & Read

Create & Edit

Publish

Delete & Restore

History

Posts

Media

Taxonomy

Advanced

Use cases

Troubleshooting