Skip to main content
WordPress.com logo
  • Category: content & files
  • Auth: OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 11
  • Triggers: 0
  • Slug: WORDPRESS_COM
  • Version: 20261101_00

Tools

Slug: WORDPRESS_COM_CREATE_DRAFT_POSTCreate a non-public draft post on an authorized site. This tool never publishes content; use the returned post ID for review, update, and cleanup.

Input Parameters

string
required
Draft title as plain text.
string
Draft body as HTML or WordPress block markup.
string
Optional draft excerpt.
integer
required
Numeric site ID returned by WORDPRESS_COM_LIST_SITES.
array
Tag IDs to assign.
array
Category IDs to assign.
string ("open" | "closed")
Whether comments should be open if the draft is later published.
Existing media item ID to use as the featured image.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORDPRESS_COM_DELETE_DRAFT_POSTPermanently delete a post after a preflight verifies that its status is draft. The status check and deletion are separate requests.

Input Parameters

integer
required
ID of a draft post to permanently delete.
integer
required
Numeric site ID returned by WORDPRESS_COM_LIST_SITES.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORDPRESS_COM_GET_POSTGet one post by ID in editable context, including raw content and its current status.

Input Parameters

integer
required
Post ID returned by create, list, or search.
integer
required
Numeric site ID returned by WORDPRESS_COM_LIST_SITES.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORDPRESS_COM_GET_SITE_OVERVIEWGet concise identity, plan, capabilities, editable settings, and traffic summary for one authorized site. Settings or stats that are unavailable by capability are reported as unavailable without hiding valid site details.

Input Parameters

integer
required
Numeric site ID returned by WORDPRESS_COM_LIST_SITES.
string ("day" | "week" | "month" | "year")
Period for the traffic summary.
integer
Number of periods to aggregate in the traffic summary.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORDPRESS_COM_LIST_BLOGGING_PROMPTSList WordPress.com writing prompts for a site, optionally filtered by date or text, with agent-controlled pagination.

Input Parameters

integer
Return the prompt calendar for this year.
string
Return prompts after this ISO 8601 date.
string ("asc" | "desc")
Sort direction by prompt date.
string
Return prompts before this ISO 8601 date.
string
Opaque continuation cursor returned by a previous call.
Limit prompts to text matching this query.
integer
required
Numeric site ID returned by WORDPRESS_COM_LIST_SITES.
integer
Maximum prompts in this page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORDPRESS_COM_LIST_CMS_RESOURCESList categories, tags, comments, media, or users for an authorized site through one consistent paginated read tool.

Input Parameters

string
Opaque continuation cursor returned by a previous call.
string
Limit results to records matching this text where the resource supports search.
integer
required
Numeric site ID returned by WORDPRESS_COM_LIST_SITES.
string ("categories" | "tags" | "comments" | "media" | "users")
required
CMS resource collection to list.
integer
Maximum resources in this page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORDPRESS_COM_LIST_CONTENTList and search editable posts or pages on an authorized site, including drafts, with compact raw and rendered content fields and agent-controlled pagination.

Input Parameters

string ("asc" | "desc")
Sort direction.
string
Opaque continuation cursor returned by a previous call.
string
Limit results to content matching this text.
integer
required
Numeric site ID returned by WORDPRESS_COM_LIST_SITES.
string ("date" | "id" | "modified" | "relevance" | "slug" | "title")
Field used to sort results.
array
Filter by provider-defined status names such as draft, pending, private, future, or publish. WordPress sites may register custom statuses; omit this field to use the provider default.
integer
Limit results to one author ID.
integer
Maximum content items in this page.
string ("posts" | "pages")
required
Content collection to list: posts or pages.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORDPRESS_COM_LIST_READER_SUBSCRIPTIONSList feeds and sites followed by the connected WordPress.com account without changing subscriptions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORDPRESS_COM_LIST_SITE_POSTSReturn one page of posts from the WordPress.com REST v1.1 collection, with documented filters, compact post details, the total found count, and an opaque continuation handle.

Input Parameters

string
Only return posts with this tag name or slug.
string
Only return posts dated after this ISO 8601 datetime.
string ("ASC" | "DESC")
Sort direction: ASC or DESC.
integer
Only return posts by this author user ID.
string
Only return posts dated before this ISO 8601 datetime.
string
Only return posts matching this search query.
string
Comma-separated post statuses, such as publish, private, draft, pending, future, trash, or any.
string ("include" | "exclude" | "require")
Include sticky posts, exclude them, or require only sticky posts.
string ("display" | "edit")
Use display for rendered HTML or edit for unparsed editable content.
string
Exclude these post IDs as a comma-separated list, such as 93,94.
string
Only return these post IDs as a comma-separated list, such as 91,92.
string
required
Numeric site ID returned by WORDPRESS_COM_LIST_SITES, or a site domain.
string
Only return posts with this category name or slug.
string
Only return posts containing this metadata key.
string ("date" | "modified" | "title" | "comment_count" | "ID")
Post field used to order the results.
integer
Maximum posts to return in this page (1-100).
integer
Only return children of this post for hierarchical post types.
string
Post type to return. Defaults to post; use any for posts and pages.
string
Metadata value to match when meta_key is also provided.
string
Opaque continuation handle returned as next_page_handle by a previous call; omit for the first page.
integer
Exclude this post and its descendants for hierarchical post types.
string
Only return posts modified after this ISO 8601 datetime.
string
Only return posts modified before this ISO 8601 datetime.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORDPRESS_COM_LIST_SITESList WordPress.com or Jetpack-connected sites authorized by the global OAuth account, optionally filtered by visibility or activity, with numeric site IDs and concise capability and plan summaries.

Input Parameters

string ("all" | "active" | "inactive")
Include all sites or filter by active or inactive status.
string ("all" | "visible" | "hidden")
Include all authorized sites or only sites visible or hidden in the user’s site list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORDPRESS_COM_UPDATE_DRAFT_POSTUpdate title, body, excerpt, taxonomy, featured media, or comment policy after a preflight verifies that the post is a draft. Provide at least one field to update; the status check and update are separate requests.

Input Parameters

string
Replacement draft title.
string
Replacement draft body as HTML or WordPress block markup.
string
Replacement excerpt.
integer
required
ID of a draft post to update.
integer
required
Numeric site ID returned by WORDPRESS_COM_LIST_SITES.
array
Replacement tag IDs; use an empty list to clear them.
array
Replacement category IDs; use an empty list to clear them.
string ("open" | "closed")
Replacement comment policy.
Replacement featured media ID; use 0 to remove it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not