capabilities.work

Create a Task and Populate Its Details

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

Recipe · 3 steps

Create a Task and Populate Its Details

with Microsoft Planner · Project Management

Create a task and set its description and checklist via task details.

  1. Create the task in the supplied plan (and optional bucket). Planner returns 201 with the created task id.
  2. Read the task details resource that was created alongside the task to capture its current ETag before patching.
  3. Patch the task details with the description, optional checklist, and preview type. The If-Match header carries the ETag read in the prior step. Planner returns 200 with the updated task details.
What you'll need to have ready
  • planId: The id of the plan the task belongs to.
  • bucketId: Optional bucket id to place the task into.
  • taskTitle: Title for the new task.
  • description: The long-form description to write onto the task details.
  • checklist: Optional plannerChecklistItems object keyed by item id, used to set the task's checklist.
  • previewType: Optional preview type shown on the task card (automatic, noPreview, checklist, description, or reference).
For your developer

Arazzo workflow microsoft-planner:create-task-with-details, 3 operations: createTask → getTaskDetails → updateTaskDetails. Specs on APIs.io.