capabilities.work

Upsert A Category

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

Recipe · 3 steps

Upsert A Category

with ReadMe

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

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

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