capabilities.work

Upsert A Custom Page

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

Recipe · 3 steps

Upsert A Custom Page

with ReadMe · Developer Portal Management

Update a custom page if its slug exists on the branch, otherwise create it.

  1. List custom pages on the branch to detect whether the target slug exists.
  2. Update the existing custom page identified by slug.
  3. Create a new custom page when no page with the target slug exists.
What you'll need to have ready
  • branch: The branch (version) the custom page lives on.
  • slug: The slug of the custom page to upsert.
  • title: The custom page title to write.
  • body: The body content to write.
  • apiKey: ReadMe API key used as a Bearer token.
For your developer

Arazzo workflow readme:upsert-custom-page, 3 operations: {$sourceDescriptions.customPagesApi.url}#/paths/~1branches~1{branch}~1custom_pages/get → {$sourceDescriptions.customPagesApi.url}#/paths/~1branches~1{branch}~1custom_pages~1{slug}/put → {$sourceDescriptions.customPagesApi.url}#/paths/~1branches~1{branch}~1custom_pages/post. Specs on APIs.io.