WordPress media

Images and files in the connected WordPress site's media library. Most often used as featured images for posts and pages.

Tools

stos_wp_media_list({ page, per_page })
stos_wp_media_get({ id })
stos_wp_media_create({ fields: { url?, data_base64?, filename?, mime?, title?, alt? } })
stos_wp_media_delete({ id })   // no force option over the connector; if WordPress refuses, the author deletes the file in their media library

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.

Two upload modes

URL ingest (preferred)

Pass a public URL — WordPress fetches and stores the bytes.

const media = await stos_wp_media_create({
  fields: {
    url: "https://example.com/cover.jpg",
    alt: "Book cover for Demon at Dusk",
  }
});

Inline base64 (firewalled / non-public sources)

When the source isn't reachable from the user's WordPress server, pass the bytes directly.

stos_wp_media_create({
  fields: {
    filename: "cover.jpg",
    mime: "image/jpeg",
    data_base64: "...",     // base64-encoded image bytes
    alt: "Book cover",
    title: "Demon at Dusk cover",
  }
});

Featured image flow

// 1. Upload
const media = await stos_wp_media_create({ fields: { url: "https://...", alt: "..." } });

// 2. Attach
stos_wp_posts_update({ id: postId, fields: { featured_media: media.id } });

Anti-patterns

• Do not upload the same file twice if you can reuse an existing one. List first, upload only when nothing matches.
• Always pass alt text. WordPress sites should have it for accessibility and SEO.

Composes well with

• wordpress-posts, wordpress-pages, wordpress-products — anywhere a featured_media ID is needed
• blog-post-and-newsletter — generates an image and uploads it as part of the pipeline