PersonalWebsites.org - Discover Personal Websites

Showing 25 of 27 from the live probe.

• Whoami

  Start here. Returns the connected account, its role, and every website it can edit with each site slug, plan, theme and live URL. Call this before anything else so you never have to ask the user which site they mean.

• List Articles

  List articles on one site, newest first, including drafts. Check here before publishing so you update an existing post instead of creating a near-duplicate.

• Get Article

  Read one article in full, by slug or by the title the user said out loud. Read before you rewrite, so you keep what they did not ask you to change. If the title matches more than one, you get the candidates back — ask which, never guess.

• Update Article

  Change parts of an existing article, found by slug or by title. Only what you pass is touched — everything else is left alone, so this is how you edit rather than rewrite. Use new_title to rename it. Blocks go in body_markdown as JSON lines (see list_blocks).

• Publish Article

  Create or update an article. Idempotent on (slug, site): if that slug exists it is UPDATED, never duplicated. Body is markdown limited to paragraphs, h2/h3, lists, bold, italic and links — images, tables, code fences and blockquotes are refused. Use upload_image plus cover_image_id for a picture. Defaults to draft; pass status "published" to put it on the live site.

• List Pages

  List the standing pages on one site (About, Contact and so on), including drafts.

• Get Page

  Read one page in full, by slug or by the title the user said. Read before rewriting so you preserve the rest of it.

• Update Page

  Change parts of an existing page, found by slug or by title. Only what you pass is touched. Use new_title to rename it.

• Find Content

  Search this site's articles AND pages by title. Use this the moment the user names something without giving a slug — it tells you what exists and which is which, instead of guessing.

• List Blocks

  The content blocks this platform supports, with the fields each one takes. Call this before adding a block so you send a shape the site can actually render.

• Publish Page

  Create or update a page. Idempotent on (slug, site), same markdown rules as publish_article. Pages have no excerpt. Defaults to draft.

• Upload Image

  Upload an image to a site. For a picture on the user's own computer, read the file and send its bytes base64-encoded as image_base64 with the original filename — that is the normal case. For one already on the web, pass image_url instead and this server fetches it. Send exactly one of the two. Returns a media id to pass as cover_image_id or to set_logo. Always write real alt text describing the picture. PNG, JPEG, GIF, WebP, AVIF, BMP, TIFF and SVG, up to 10MB.

• List Media

  List images already uploaded to a site, newest first, so you can reuse one instead of uploading it again.

• Set Logo

  Set the site header logo to an image already uploaded. Pass a media id from upload_image or list_media. Leaving it empty makes the header fall back to the site name as text.

• List Themes

  List the themes this site may actually use. The list is already filtered to the customer's plan, so anything it returns is safe to pass to set_theme.

• Set Theme

  Switch the site's theme. Only themes from list_themes are allowed: the plan cap is enforced by the CMS, and a theme outside it is silently reverted, so read the result back before saying it worked. Changing theme rebuilds the whole site.

• Update Branding

  Update the site's own details: name, tagline, jobTitle, niche, footerText, socials, heroStats, topics, authorBio. Send only what you are changing. Operator-only fields (slug, domains, plan, deploy settings) are silently reverted if sent, so do not try. Rebuilds the site.

• Create Category

  Create a category for tagging articles on this site. Check list_categories first — reusing an existing one is almost always right.

• Get Nav

  The site's header and footer menus, in order. Read this before changing a menu so you keep the items the user did not mention.

• Set Nav

  Replace the header and/or footer menu. Send the WHOLE menu in the order you want — this is not a merge, so call get_nav first and include the items you are keeping. Each item is either a page (give its slug) or the auto-generated articles link.

• Set Hero

  Set the big picture at the top of the home page. Which field that is depends on the theme, and this works it out: marquee and neon use a full-bleed hero image, every other theme uses the logo. Pass a media id from upload_image.

• Set Media Alt

  Change an image's alt text — the description screen readers announce and search engines read. Worth fixing whenever it is missing or unhelpful.

• Rebuild Site

  Rebuild and redeploy the site. Use it when someone says a change has not shown up yet — but check first: a normal publish already rebuilds, and a build takes a minute or two, so waiting is usually the answer rather than rebuilding again.

• Delete Article

  Permanently delete an article, found by slug or title. This cannot be undone. ALWAYS show the user which article you found and get a clear yes before passing confirm true. If they only want it off the site, use update_article with status "draft" instead — that keeps the writing.

• Delete Page

  Permanently delete a page, found by slug or title. This cannot be undone. ALWAYS confirm with the user first. To just take it off the site, use update_page with status "draft" instead.