WordPress posts

The user's connected WordPress site is the source of truth for blog posts. This skill writes to it through StorytellerOS.

Tools

stos_wp_posts_list({ status, search, page, per_page })
stos_wp_posts_get({ id })
stos_wp_posts_create({ fields: { title, content, excerpt, slug, status, date, categories, tags, featured_media } })
stos_wp_posts_update({ id, fields: { ... } })
stos_wp_posts_delete({ id })   // moves the post to WordPress trash; permanent deletion is done in WordPress itself

All tools take an optional penNameId — the user can connect one WordPress site per pen name plus an account default. Omit for the account default; pass a pen name id (from stos_pen_names_list) to act on that pen name's site. When the user has multiple pen names and it's ambiguous which site they mean, ask.

Field shapes

Patterns

Draft a new post

const post = await stos_wp_posts_create({
  fields: {
    title: "Why I Killed My Side Plot",
    content: "<p>Three rewrites in, the side plot was dead weight. Here's how I cut it without losing the emotional through-line.</p>",
    excerpt: "Why side plots fail and what to do about them.",
    status: "draft",
    tags: ["craft", "revision"],
  }
});

Schedule for later

stos_wp_posts_create({
  fields: {
    title: "Launch day post",
    content: "<p>...</p>",
    status: "future",
    date: "2026-06-01T08:00:00Z",
  }
});

Publish an existing draft

stos_wp_posts_update({ id: 123, fields: { status: "publish" } });

Add a featured image from a public URL

const media = await stos_wp_media_create({
  fields: { url: "https://stos-cdn/cover-2026-launch.jpg", alt: "Launch banner" }
});
stos_wp_posts_update({ id: 123, fields: { featured_media: media.id } });

Anti-patterns

• Do not store post content as Markdown — WordPress doesn't render it natively. Convert to HTML before sending.
• Do not pass tag IDs to tags. WordPress's REST API for our plugin accepts tag names only; IDs are categories' domain.
• Do not assume the user wants to publish. Default to status: "draft" unless they explicitly say "publish".

Composes well with

• wordpress-media — upload featured images
• blog-post-and-newsletter — full pipeline that drafts post + image + newsletter from one prompt