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.
- Create the task in the supplied plan (and optional bucket). Planner returns 201 with the created task id.
- Read the task details resource that was created alongside the task to capture its current ETag before patching.
- 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.