capabilities.work

Rename a Plan and Describe Its Categories

A 4-step recipe with Microsoft Planner. We can help you get access.

Recipe · 4 steps

Rename a Plan and Describe Its Categories

Rename a plan and set its category label descriptions.

  1. Read the plan to capture its current ETag for the rename's If-Match header.
  2. Read the plan details to capture its ETag for the category-description patch's If-Match header.
  3. Patch the plan with the new title. The If-Match header carries the plan ETag. Planner returns 200 with the updated plan.
  4. Patch the plan details with category label descriptions. The If-Match header carries the plan details ETag. Planner returns 200 with the updated plan details.
What you'll need to have ready
  • planId: The id of the plan to rename.
  • newTitle: The new title for the plan.
  • categoryDescriptions: Optional plannerCategoryDescriptions object (category1..category25) giving human labels to the plan's category columns.
For your developer

Arazzo workflow microsoft-planner:rename-plan, 4 operations: getPlan → getPlanDetails → updatePlan → updatePlanDetails. Specs on APIs.io.