View as Markdown
Microsoft 365 Planner icon

Microsoft 365 Planner ACTION

Update Task

Updates a task in Microsoft 365 Planner. See the documentation
  • Action
  • Writes data
  • Destructive
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Microsoft 365 Planner account once, then configure and run Update Task from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "microsoft_365_planner-update-task",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    microsoft_365_planner: { authProvisionId: "apn_xxxxxxx" },
    taskId: "User Task ID",
    title: "Title",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Update Task inputs
Property Type Description
taskId User Task ID string
Identifier of a user task
Required Dynamic
title Title string
Title of the task
Optional
priority Priority integer
Priority of the task. The valid range of values is between 0 and 10, with the increasing value being lower priority (0 has the highest priority and 10 has the lowest priority)
Optional
percentComplete Percent Complete integer
Percentage of task completion. When set to 100, the task is considered completed.
Optional
dueDateTime Due Date Time string
Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
Optional
startDateTime Start Date Time string
Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
Optional
orderHint Order Hint string
Hint used to order items of this type in a list view. The format is defined in Using order hints in Planner.
Optional
assigneePriority Assignee Priority string
Hint used to order items of this type in a list view. The format is defined as outlined here.
Optional
groupId Group string
The group container of the plan
Optional Dynamic
conversationThreadId Conversation Thread ID string
Identifier of the conversation thread associated with the task.
Optional Dynamic
assignmentIds Assignees string[]
Array of assignee Ids
Optional Dynamic
planId Plan string
Identifier of a plan
Optional Dynamic
bucketId Bucket string
Identifier of a bucket
Optional Dynamic
appliedCategories Applied Categories string[]
The categories to which the task has been applied. See applied Categories for possible values.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
microsoft_365_planner-update-task
Version
0.0.5
App
Microsoft 365 Planner
Authentication
OAuth
Read-only
No
Destructive
Yes
Open world
Yes