vibe-pub

Showing 25 of 29 from the live probe.

• Publish

  Publish markdown content to vibe.pub. Local absolute-path images in  are uploaded automatically. Returns the page id, slug, and URL.

• Get Page

  Get a page by its slug. Returns full page details including markdown content.

• Update Page

  Update a page identified by slug. Pass markdown to replace content (creates a version snapshot), and/or access to change visibility only.

• Delete Page

  Delete a page identified by slug.

• List Pages

  List pages for the authenticated user. Requires auth token.

• Get Comments

  List comments for a page by slug. Each block-anchored comment includes block_text (plain-text preview of the anchored block). Existing comments expose anchor.block_id for reuse when anchoring new replies. By default only unresolved (open) comments; set include_resolved to include resolved threads.

• Add Comment

  Add a comment to a page identified by slug.

• Resolve Comments

  Resolve comments on a page. Either resolve all comments or specific ones by ID.

• Get Versions

  List version history for a page identified by slug.

• Get Version

  Get a specific version of a page by slug and version number.

• Create Collection

  Create a collection. Prefer `parts` for grouped sections; use `page_slugs` for ungrouped pages (after parts). Fill readers_guide, what_its_about, who_its_for, and how_to_read_it for the cover. Returns id, slug, url, parts, ungrouped_pages.

• Update Collection

  Update collection metadata (title, description, access, reader's guide fields).

• Get Collection

  Get collection details and its pages by slug.

• Add To Collection

  Add a page to an existing collection.

• List Collection Parts

  List parts in a collection.

• Create Collection Part

  Create a part (section) in a collection. Returns id and title.

• Update Collection Part

  Update a collection part title or sort order.

• Delete Collection Part

  Delete a part. Pages in the part become ungrouped.

• Remove From Collection

  Remove a page from a collection.

• List Collections

  List collections for the authenticated user. Requires auth token.

• Delete Collection

  Delete a collection by slug. Pages in the collection are not deleted.

• Format

  Get markdown format reference for agents before publishing. Use doc for long-form pages or kanban for board pages.

• Whoami

  Show current authentication status and API base URL.

• Access Page Status

  Get access level and share list for a page (domains and users with access).

• Access Page Share

  Share a private page with a user by email or an email domain.