capabilities.work

Find and Revise a Blog Post

A 3-step recipe with Confluence. We can help you get access.

Recipe · 3 steps

Find and Revise a Blog Post

Works with AI assistants

Locate a Confluence blog post by title and publish a corrected body.

  1. Filter current blog posts by exact title, returning at most one match so the revision cannot be applied to the wrong post.
  2. Read the matched blog post in storage format to capture the current version number the update must supersede and the original body for comparison.
  3. Write the revised body with an incremented version and a changelog message. A 400 here usually means the version number was not current + 1.
What you'll need to have ready
  • title: The exact title of the blog post to revise.
  • revisedBody: The corrected blog post body in Confluence storage format (XHTML).
  • newVersionNumber: The version number to write, which Confluence requires to be the current version plus one. Arazzo runtime expressions have no arithmetic, so the caller supplies
  • versionMessage: Changelog message explaining the correction, recorded on the new version.
For your developer

Arazzo workflow confluence:revise-blog-post, 3 operations: getBlogPosts → getBlogPostById → updateBlogPost. Specs on APIs.io.