Content abilities: posts, pages, and custom post types

Content abilities let you manage any registered post type on your WordPress site — posts, pages, WooCommerce products, or any custom type your theme or plugins register. Every write operation is permission-gated and recorded in the audit log, so you always have a clear trail of what changed.

All content abilities

Ability	Description	Capability	Plan
`maxi/create-content`	Create a new post, page, or custom post type entry.	`edit_posts`	Lite
`maxi/get-content`	Get a single post or page by ID.	`read`	Lite
`maxi/get-content-by-slug`	Get a post or page by its URL slug.	`read`	Lite
`maxi/update-content`	Update any post or page fields. Send only the fields you want to change.	`edit_posts`	Lite
`maxi/delete-content`	Delete or trash a post or page.	`delete_posts`	Lite
`maxi/list-content`	List posts or pages with filters for type, status, author, and parent.	`read`	Lite
`maxi/search-content`	Search by keyword, taxonomy, meta, author, or date range across all post types.	`read`	Lite
`maxi/duplicate-content`	Duplicate a post along with all its meta and taxonomy terms.	`edit_posts`	Lite
`maxi/change-status`	Change a post’s status to publish, draft, pending, private, or trash.	`edit_posts`	Lite
`maxi/schedule-content`	Schedule a post for future publication at a specific date and time.	`publish_posts`	Lite
`maxi/set-author`	Change the author of a post.	`edit_others_posts`	Lite
`maxi/set-parent`	Set or remove the parent of a hierarchical post type (pages, etc.).	`edit_pages`	Lite

All content abilities accept a post_type parameter. Pass any registered post type: post, page, product, or any custom type on your site. Abilities that don’t receive post_type default to searching across all registered types.

Write gate

Write abilities — any ability that creates, updates, or deletes content — require the WordPress user connected to your AI client to have the administrator role (manage_options). This check is enforced in PHP server-side and cannot be bypassed. Read abilities (get-content, list-content, search-content) work for any authenticated user.

Key ability examples

maxi/create-content

Create a new post or page. Pass the content as valid Gutenberg block HTML (see Content format below).

{
  "post_type": "post",
  "title": "My New Article",
  "content": "<!-- wp:paragraph --><p>Content here.</p><!-- /wp:paragraph -->",
  "status": "draft"
}

maxi/get-content

Retrieve a single post by its numeric ID.

{ "id": 123 }

maxi/list-content

List posts with filters. All list-* abilities accept orderby, order, per_page, and page.

{
  "post_type": "post",
  "status": "publish",
  "per_page": 10,
  "page": 1,
  "orderby": "date",
  "order": "DESC"
}

maxi/update-content

Update specific fields on an existing post. Send only the fields you want to change — you do not need to repeat unchanged fields.

{
  "id": 123,
  "title": "Updated Title"
}

Read before writing content. If you need to update the content field, you must first call maxi/get-content or maxi/get-content-by-slug for that post in the same session. This prevents you from overwriting content you haven’t read. Skipping the read step causes the update to be rejected.

maxi/search-content

Search by keyword, taxonomy, meta values, author, or a date range.

{
  "search": "wordpress plugin",
  "post_type": "post",
  "status": "publish"
}

maxi/schedule-content

Schedule an existing draft for publication at a future date and time. Use MySQL datetime format (YYYY-MM-DD HH:MM:SS).

{
  "id": 123,
  "date": "2025-12-01 09:00:00"
}

Content format

For new content, use Gutenberg block HTML. Plain HTML, shortcodes, and classic-editor content are also accepted — WordPress core’s block parser handles all of these. Only an empty or whitespace-only string is rejected.

Paragraph
Heading
List
Code
Table

<!-- wp:paragraph -->
<p>Your paragraph text goes here.</p>
<!-- /wp:paragraph -->

<!-- wp:heading -->
<h2>Section Title</h2>
<!-- /wp:heading -->

<!-- wp:heading {"level":3} -->
<h3>Sub-heading</h3>
<!-- /wp:heading -->

<!-- wp:heading {"anchor":"my-id"} -->
<h2 class="wp-block-heading" id="my-id">Anchored Heading</h2>
<!-- /wp:heading -->

<!-- wp:list -->
<ul>
<li>Item one</li>
<li>Item two</li>
</ul>
<!-- /wp:list -->

<!-- wp:code -->
<pre class="wp-block-code"><code>your code here</code></pre>
<!-- /wp:code -->

<!-- wp:table -->
<figure class="wp-block-table"><table><thead><tr><th>Col</th></tr></thead><tbody><tr><td>Val</td></tr></tbody></table></figure>
<!-- /wp:table -->

You can combine multiple blocks in a single content value by concatenating them. Each block must have its own opening and closing comment delimiters.

Audit log

Every content mutation is recorded in the audit log under the content category. Events include content_created, content_updated, content_deleted, content_duplicated, status_changed, content_scheduled, author_changed, and parent_changed. Query them with maxi/get-audit-events using { "category": "content" }.

Overview

Content & Media

AI Generation

WooCommerce

System & Dev

Content abilities: posts, pages, and custom post types

All content abilities

Write gate

Key ability examples

maxi/create-content

maxi/get-content

maxi/list-content

maxi/update-content

maxi/search-content

maxi/schedule-content

Content format

Audit log

​All content abilities

​Write gate

​Key ability examples

​maxi/create-content

​maxi/get-content

​maxi/list-content

​maxi/update-content

​maxi/search-content

​maxi/schedule-content

​Content format

​Audit log

All content abilities

Write gate

Key ability examples

maxi/create-content

maxi/get-content

maxi/list-content

maxi/update-content

maxi/search-content

maxi/schedule-content

Content format

Audit log