Connectors Reference

Planner

Microsoft Planner lets you easily bring together teams, tasks, documents, and conversations for better results.

 

Status: Production

Tier: Standard

Version: 1.0.0

 

Actions:

Name

Summary

GetTask_V2 (string id)

Get a task

DeleteTask (string id)

Delete a task

UpdateTask_V2 (string id, [internal]string prefer, UpdateTask_Request_V2 body)

Update a task

UpdateTask_V3 (string id, [internal]string prefer, UpdateTask_Request_V3 body)

Update a task (V2)

CreateTask_V3 ([internal]string prefer, CreateTask_Request_V3 body)

Create a task

CreateTask_V4 ([internal]string prefer, CreateTask_Request_V4 body)

Create a task

ListTasks_V3 (string groupId, string id)

List tasks

ListMyTasks_V2 ()

List my tasks

UnassignUsers (string id, [internal]string prefer, UnassignUsersParameterBody body)

Remove assignees from a task

AssignUsers (string id, [internal]string prefer, AssignUsersParameterBody body)

Add assignees to a task

ListBuckets_V3 (string groupId, string id)

List buckets

CreateBucket_V2 (CreateBucket_V2ParameterBody body)

Create a bucket

GetTaskDetails_V2 (string id)

Get task details

UpdateTaskDetails_V2 (string id, UpdateTaskDetails_Request body, [internal]string prefer)

Update task details

ListGroupPlans (string groupId)

List plans for a group

ListGroups ()

List groups that I am member of

GetTask (string id)

Get a task

UpdateTask (string id, [internal]string prefer, UpdateTask_Request body)

Update a task

ListBuckets (string id)

List buckets

CreateTask ([internal]string prefer, CreateTask_Request body)

Create a task

ListTasks (string id)

List tasks

ListMyTasks ()

List my tasks

ListMyPlans ()

List my plans

GetTaskDetails (string id)

Get task details

UpdateTaskDetails (string id, UpdateTaskDetails_Request body, [internal]string prefer)

Update task details

ListBuckets_V2 (string id)

List buckets

CreateBucket (CreateBucketParameterBody body)

Create a bucket

CreateTask_V2 ([internal]string prefer, CreateTask_Request_V2 body)

Create a task

ListTasks_V2 (string id)

List tasks

ListMyPlans_V2 ()

List my plans

GetPlanDetails (string id)

Get plan details

 

Triggers:

Name

Summary

OnNewTask (string id)

When a new task is created

OnCompleteTask (string id)

When a task is completed

OnTaskAssignedToMe ()

When a task is assigned to me

OnNewTask_V2 (string id)

When a new task is created

OnNewTask_V3 (string groupId, string id)

When a new task is created

OnCompleteTask_V2 (string id)

When a task is completed

OnCompleteTask_V3 (string groupId, string id)

When a task is completed

OnTaskAssignedToMe_V2 ()

When a task is assigned to me

 

Objects:

Name

Summary

AppliedCategories

 

AssignUsersParameterBody

 

CreateBucketParameterBody

 

CreateBucket_Response

 

CreateBucket_V2ParameterBody

 

CreateTask_Request

 

CreateTask_Request_V2

 

CreateTask_Request_V3

 

CreateTask_Request_V4

 

GetPlanDetails_Response

 

GetTaskDetails_Response

 

GetTask_Response

 

GetTask_Response_V2

 

GetTask_Response_V3

 

ListBuckets_Response

 

ListGroups_Response

 

ListMyPlans_Response

 

ListTasks_Response

 

ListTasks_Response_V2

 

UnassignUsersParameterBody

 

UpdateTaskDetails_Request

 

UpdateTask_Request

 

UpdateTask_Request_V2

 

UpdateTask_Request_V3

 

 

Actions:

GetTask_V2

Summary: Get a task

Description: Get an existing Planner task.

 

Syntax:

Planner.GetTask_V2 (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifier of the task to update.

True

ListMyTasks_V2

 

Returns:

          Type:GetTask_Response_V2

 

DeleteTask

Summary: Delete a task

Description: Deletes an existing Planner task.

 

Syntax:

Planner.DeleteTask (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifier of the task to delete.

True

ListMyTasks_V2

 

Returns:

 

UpdateTask_V2

Summary: Update a task

Description: Update an existing Planner task.

 

Syntax:

Planner.UpdateTask_V2 (string id, [internal]string prefer, UpdateTask_Request_V2 body)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifier of the task to update.

True

ListMyTasks_V2

prefer

string

(prefer)

prefer

True

body

UpdateTask_Request_V2

 

 

True

 

Returns:

          Type:GetTask_Response_V2

 

UpdateTask_V3

Summary: Update a task (V2)

Description: Update an existing Planner task.

 

Syntax:

Planner.UpdateTask_V3 (string id, [internal]string prefer, UpdateTask_Request_V3 body)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifier of the task to update.

True

ListMyTasks_V2

prefer

string

(prefer)

prefer

True

body

UpdateTask_Request_V3

 

 

True

 

Returns:

          Type:GetTask_Response_V2

 

CreateTask_V3

Summary: Create a task

Description: Create a new task in Planner.

 

Syntax:

Planner.CreateTask_V3 ([internal]string prefer, CreateTask_Request_V3 body)

 

Parameters:

Name

Type

Summary

Required

Related Action

prefer

string

(prefer)

prefer

True

body

CreateTask_Request_V3

 

 

True

 

Returns:

          Type:GetTask_Response_V2

 

CreateTask_V4

Summary: Create a task

Description: Create a new task in Planner.

 

Syntax:

Planner.CreateTask_V4 ([internal]string prefer, CreateTask_Request_V4 body)

 

Parameters:

Name

Type

Summary

Required

Related Action

prefer

string

(prefer)

prefer

True

body

CreateTask_Request_V4

 

 

True

 

Returns:

          Type:GetTask_Response_V3

 

ListTasks_V3

Summary: List tasks

Description: List the tasks in a plan.

 

Syntax:

Planner.ListTasks_V3 (string groupId, string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

groupId

string

(Group Id)

The group to retrieve the plan.

True

ListGroups

id

string

(Plan Id)

The unique identifier of the plan.

True

ListGroupPlans

 

Returns:

          Type:ListTasks_Response_V2

 

ListMyTasks_V2

Summary: List my tasks

Description: List the tasks assigned to me.

 

Syntax:

Planner.ListMyTasks_V2 ()

 

Returns:

          Type:ListTasks_Response_V2

 

UnassignUsers

Summary: Remove assignees from a task

Description: Remove assignees from an existing Planner task.

 

Syntax:

Planner.UnassignUsers (string id, [internal]string prefer, UnassignUsersParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifier of the task to update.

True

ListMyTasks_V2

prefer

string

(prefer)

prefer

True

body

UnassignUsersParameterBody

 

 

True

 

Returns:

          Type:GetTask_Response_V2

 

AssignUsers

Summary: Add assignees to a task

Description: Add assignees to an existing Planner task.

 

Syntax:

Planner.AssignUsers (string id, [internal]string prefer, AssignUsersParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifier of the task to update.

True

ListMyTasks_V2

prefer

string

(prefer)

prefer

True

body

AssignUsersParameterBody

 

 

True

 

Returns:

          Type:GetTask_Response_V2

 

ListBuckets_V3

Summary: List buckets

Description: List the buckets in a plan.

 

Syntax:

Planner.ListBuckets_V3 (string groupId, string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

groupId

string

(Group Id)

The group to retrieve the plan.

True

ListGroups

id

string

(Plan Id)

The unique identifier of the plan.

True

ListGroupPlans

 

Returns:

          Type:ListBuckets_Response

 

CreateBucket_V2

Summary: Create a bucket

Description: Create a bucket in Planner for the specified plan and group.

 

Syntax:

Planner.CreateBucket_V2 (CreateBucket_V2ParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

body

CreateBucket_V2ParameterBody

 

 

True

 

Returns:

          Type:CreateBucket_Response

 

GetTaskDetails_V2

Summary: Get task details

Description: Get the task details for an existing task.

 

Syntax:

Planner.GetTaskDetails_V2 (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifier of the task to update.

True

ListMyTasks_V2

 

Returns:

          Type:GetTaskDetails_Response

 

UpdateTaskDetails_V2

Summary: Update task details

Description: Update the task details for an existing task.

 

Syntax:

Planner.UpdateTaskDetails_V2 (string id, UpdateTaskDetails_Request body, [internal]string prefer)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifier of the task to update.

True

ListMyTasks_V2

body

UpdateTaskDetails_Request

 

 

True

prefer

string

(prefer)

prefer

True

 

Returns:

          Type:GetTaskDetails_Response

 

ListGroupPlans

Summary: List plans for a group

Description: List plans owned by the group specified.

 

Syntax:

Planner.ListGroupPlans (string groupId)

 

Parameters:

Name

Type

Summary

Required

Related Action

groupId

string

(Group Id)

Id of the group.

True

ListGroups

 

Returns:

          Type:ListMyPlans_Response

 

ListGroups

Summary: List groups that I am member of

Description: Get groups that the user is a direct member of.

 

Syntax:

Planner.ListGroups ()

 

Returns:

          Type:ListGroups_Response

 

GetTask

Summary: Get a task

Description: Get an existing Planner task.

 

Syntax:

Planner.GetTask (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifer of the task.

True

 

Returns:

          Type:GetTask_Response

 

UpdateTask

Summary: Update a task

Description: Update an existing Planner task.

 

Syntax:

Planner.UpdateTask (string id, [internal]string prefer, UpdateTask_Request body)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifier of the tast to update.

True

ListMyTasks

prefer

string

(prefer)

prefer

True

body

UpdateTask_Request

 

 

True

 

Returns:

          Type:GetTask_Response

 

ListBuckets

Summary: List buckets

Description: List the buckets in a plan.

 

Syntax:

Planner.ListBuckets (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Plan Id)

The unique identifier of the plan.

True

ListMyPlans_V2

 

Returns:

          Type:ListBuckets_Response

 

CreateTask

Summary: Create a task

Description: Create a new task in Planner.

 

Syntax:

Planner.CreateTask ([internal]string prefer, CreateTask_Request body)

 

Parameters:

Name

Type

Summary

Required

Related Action

prefer

string

(prefer)

prefer

True

body

CreateTask_Request

 

 

True

 

Returns:

          Type:GetTask_Response

 

ListTasks

Summary: List tasks

Description: List the tasks in a plan.

 

Syntax:

Planner.ListTasks (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Plan Id)

The unique identifier of the plan.

True

ListMyPlans_V2

 

Returns:

          Type:ListTasks_Response

 

ListMyTasks

Summary: List my tasks

Description: List the tasks assigned to me.

 

Syntax:

Planner.ListMyTasks ()

 

Returns:

          Type:ListTasks_Response

 

ListMyPlans

Summary: List my plans

Description: List the plans the user has subscribed to.

 

Syntax:

Planner.ListMyPlans ()

 

Returns:

          Type:ListMyPlans_Response

 

GetTaskDetails

Summary: Get task details

Description: Get the task details for an existing task.

 

Syntax:

Planner.GetTaskDetails (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifer of the task.

True

 

Returns:

          Type:GetTaskDetails_Response

 

UpdateTaskDetails

Summary: Update task details

Description: Update the task details for an existing task.

 

Syntax:

Planner.UpdateTaskDetails (string id, UpdateTaskDetails_Request body, [internal]string prefer)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Task Id)

The unique identifer of the task.

True

body

UpdateTaskDetails_Request

 

 

True

prefer

string

(prefer)

prefer

True

 

Returns:

          Type:GetTaskDetails_Response

 

ListBuckets_V2

Summary: List buckets

Description: List the buckets in a plan.

 

Syntax:

Planner.ListBuckets_V2 (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Plan Id)

The unique identifier of the plan.

True

ListMyPlans_V2

 

Returns:

          Type:ListBuckets_Response

 

CreateBucket

Summary: Create a bucket

Description: Create a bucket in Planner.

 

Syntax:

Planner.CreateBucket (CreateBucketParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

body

CreateBucketParameterBody

 

 

True

 

Returns:

          Type:CreateBucket_Response

 

CreateTask_V2

Summary: Create a task

Description: Create a new task in Planner.

 

Syntax:

Planner.CreateTask_V2 ([internal]string prefer, CreateTask_Request_V2 body)

 

Parameters:

Name

Type

Summary

Required

Related Action

prefer

string

(prefer)

prefer

True

body

CreateTask_Request_V2

 

 

True

 

Returns:

          Type:GetTask_Response_V2

 

ListTasks_V2

Summary: List tasks

Description: List the tasks in a plan.

 

Syntax:

Planner.ListTasks_V2 (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Plan Id)

The unique identifier of the plan.

True

ListMyPlans_V2

 

Returns:

          Type:ListTasks_Response_V2

 

ListMyPlans_V2

Summary: List my plans

Description: List the plans the user has subscribed to.

 

Syntax:

Planner.ListMyPlans_V2 ()

 

Returns:

          Type:ListMyPlans_Response

 

GetPlanDetails

Summary: Get plan details

Description: Get plan details where the task belongs to

 

Syntax:

Planner.GetPlanDetails (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Plan Id)

The unique plan id.

True

 

Returns:

          Type:GetPlanDetails_Response

 

Triggers:

Trigger OnNewTask

Summary: When a new task is created

Description: This operation triggers when a new task is created.

 

Syntax:

Planner.OnNewTask (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Plan Id)

The unique identifier of the plan.

True

ListMyPlans_V2

 

Returns:

          Type:ListTasks_Response

 

Trigger OnCompleteTask

Summary: When a task is completed

Description: This operation triggers when a task is completed.

 

Syntax:

Planner.OnCompleteTask (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Plan Id)

The unique identifier of the plan.

True

ListMyPlans_V2

 

Returns:

          Type:ListTasks_Response

 

Trigger OnTaskAssignedToMe

Summary: When a task is assigned to me

Description: This operation triggers when a task is assigned to me.

 

Syntax:

Planner.OnTaskAssignedToMe ()

 

Returns:

          Type:ListTasks_Response

 

Trigger OnNewTask_V2

Summary: When a new task is created

Description: This operation triggers when a new task is created.

 

Syntax:

Planner.OnNewTask_V2 (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Plan Id)

The unique identifier of the plan.

True

ListMyPlans_V2

 

Returns:

          Type:ListTasks_Response_V2

 

Trigger OnNewTask_V3

Summary: When a new task is created

Description: This operation triggers when a new task is created.

 

Syntax:

Planner.OnNewTask_V3 (string groupId, string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

groupId

string

(Group Id)

The group to retrieve the plan.

True

ListGroups

id

string

(Plan Id)

The unique identifier of the plan.

True

ListGroupPlans

 

Returns:

          Type:ListTasks_Response_V2

 

Trigger OnCompleteTask_V2

Summary: When a task is completed

Description: This operation triggers when a task is completed.

 

Syntax:

Planner.OnCompleteTask_V2 (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Plan Id)

The unique identifier of the plan.

True

ListMyPlans_V2

 

Returns:

          Type:ListTasks_Response_V2

 

Trigger OnCompleteTask_V3

Summary: When a task is completed

Description: This operation triggers when a task is completed.

 

Syntax:

Planner.OnCompleteTask_V3 (string groupId, string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

groupId

string

(Group Id)

The group to retrieve the plan.

True

ListGroups

id

string

(Plan Id)

The unique identifier of the plan.

True

ListGroupPlans

 

Returns:

          Type:ListTasks_Response_V2

 

Trigger OnTaskAssignedToMe_V2

Summary: When a task is assigned to me

Description: This operation triggers when a task is assigned to me.

 

Syntax:

Planner.OnTaskAssignedToMe_V2 ()

 

Returns:

          Type:ListTasks_Response_V2

 


 

AppliedCategories

Summary:

Description: The categories to which the task has been applied.

 

          Properties:

Name

Type

Summary

category1

boolean

Pink

True if the task has the Pink category.

category2

boolean

Red

True if the task has the Red category.

category3

boolean

Yellow

True if the task has the Yellow category.

category4

boolean

Green

True if the task has the Green category.

category5

boolean

Blue

True if the task has the Blue category.

category6

boolean

Purple

True if the task has the Purple category.


 

AssignUsersParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

assignments

string

Assigned User Ids

Semi-colon seperated ids or email addresses of users who should be assigned to this task.


 

CreateBucketParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

name

string

Name

Name of the bucket

planId

string

Plan Id

The plan for the new bucket


 

CreateBucket_Response

Summary:

Description:

 

          Properties:

Name

Type

Summary

name

string

Name

Name of the bucket

planId

string

Plan Id

Plan ID to which the bucket belongs

orderHint

string

Order hint

Hint used to order items of this type in a list view

id

string

Id

ID of the bucket


 

CreateBucket_V2ParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

name

string

Name

Name of the bucket

groupId

string

Group Id

The group to retrieve the plan.

planId

string

Plan Id

The plan for the new bucket.


 

CreateTask_Request

Summary:

Description:

 

          Properties:

Name

Type

Summary

planId

string

Plan Id

The plan for the new task.

title

string

Title

The title of the new task.

bucketId

string

Bucket Id

The bucket to place this task in.

startDateTime

string(date-time)

Start Date Time

The datetime the task starts (Ex. '2018-04-13T00:42:19.284Z').

dueDateTime

string(date-time)

Due Date Time

The datetime the task is due (Ex. '2018-04-13T00:42:19.284Z').

assignments

string

Assigned User Id

The id or email address of the user to assign this task to.


 

CreateTask_Request_V2

Summary:

Description:

 

          Properties:

Name

Type

Summary

planId

string

Plan Id

The plan for the new task.

title

string

Title

The title of the new task.

bucketId

string

Bucket Id

The bucket to place this task in.

startDateTime

string(date-time)

Start Date Time

The datetime the task starts (Ex. '2018-04-13T00:42:19.284Z').

dueDateTime

string(date-time)

Due Date Time

The datetime the task is due (Ex. '2018-04-13T00:42:19.284Z').

assignments

string

Assigned User Ids

Semi-colon seperated ids or email addresses of users to assign this task to.


 

CreateTask_Request_V3

Summary:

Description:

 

          Properties:

Name

Type

Summary

groupId

string

Group Id

The group to retrieve the plan.

planId

string

Plan Id

The plan for the new task.

title

string

Title

The title of the new task (maximum of 255 chars).

bucketId

string

Bucket Id

The bucket to place this task in.

startDateTime

string(date-time)

Start Date Time

The datetime the task starts (Ex. '2018-04-13T00:42:19.284Z').

dueDateTime

string(date-time)

Due Date Time

The datetime the task is due (Ex. '2018-04-13T00:42:19.284Z').

assignments

string

Assigned User Ids

Semi-colon separated ids or email addresses of users to assign this task to.

appliedCategories

AppliedCategories

 

The categories to which the task has been applied.


 

CreateTask_Request_V4

Summary:

Description:

 

          Properties:

Name

Type

Summary

groupId

string

Group Id

The group to retrieve the plan.

planId

string

Plan Id

The plan for the new task.

title

string

Title

The title of the new task (maximum of 255 chars).

bucketId

string

Bucket Id

The bucket to place this task in.

startDateTime

string(date-time)

Start Date Time

The datetime the task starts (Ex. '2018-04-13T00:42:19.284Z').

dueDateTime

string(date-time)

Due Date Time

The datetime the task is due (Ex. '2018-04-13T00:42:19.284Z').

assignments

string

Assigned User Ids

Semi-colon separated ids or email addresses of users to assign this task to.

appliedCategories

AppliedCategories

 

The categories to which the task has been applied.

priority

integer(int32)

Priority

Priority of the task. Valid range of values is between 0 and 10 (inclusive), with increasing value being lower priority (0 has the highest priority and 10 has the lowest priority). Currently, Planner interprets values 0 and 1 as "urgent", 2 and 3 and 4 as "important", 5, 6, and 7 as "medium", and 8, 9, and 10 as "low". Currently, Planner sets the value 1 for "urgent", 3 for "important", 5 for "medium", and 9 for "low".


 

GetPlanDetails_Response

Summary:

Description:

 

          Properties:

Name

Type

Summary

categoryDescriptions

CategoryDescriptions

Category descriptions

 

id

string

Id

The ID of the plan details

 

CategoryDescriptions

Summary: Category descriptions

Description:

 

          Properties:

Name

Type

Summary

category1

string

Category 1

The category 1.

category2

string

Category 2

The category 2.

category3

string

Category 3

The category 3.

category4

string

Category 4

The category 4.

category5

string

Category 5

The category 5.

category6

string

Category 6

The category 6.

 


 

GetTaskDetails_Response

Summary:

Description:

 

          Properties:

Name

Type

Summary

description

string

Description

The description of the task.

id

string

Id

The id of the task.

references

array of (ReferencesItem)

References

The collection of references on the task

checklist

array of (ChecklistItem)

Checklist

The collection of checklist items on the task.

 

ReferencesItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

resourceLink

string(uri)

Resource link

A valid URL based on the HTTP/HTTPS protocols.

value

Value

 

 

 

Value

Summary:

Description:

 

          Properties:

Name

Type

Summary

alias

string

Alias

A name alias to describe the reference.

type

Type

Type of the reference

Used to describe the type of the reference.  Values: [PowerPoint, Word, Excel, OneNote, Project, Visio, Pdf, Other]

 

Type

Summary: Type of the reference

Description: Used to describe the type of the reference.

 

          Properties:

Name

Type

Summary

 

ChecklistItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

Id

A number representing the checklist item.

value

Value

 

 

 

Value

Summary:

Description:

 

          Properties:

Name

Type

Summary

title

string

Title

The name of the checklist item.

isChecked

boolean

Is Checked

Whether or not the item is checked.

 


 

GetTask_Response

Summary:

Description:

 

          Properties:

Name

Type

Summary

createdBy

CreatedBy

Created By

 

planId

string

Plan Id

The id of the plan this task belongs to.

bucketId

string

Bucket Id

The id of the bucket this task belongs to.

title

string

Title

The title of the task.

percentComplete

integer(int32)

Percent Complete

The completion percentage of the task.

startDateTime

string(date-time)

Start Date Time

The start datetime of the task.

createdDateTime

string(date-time)

Created Date Time

The datetime the task was created.

dueDateTime

string(date-time)

Due Date Time

The datetime the task is due.

hasDescription

boolean

Has Description

Set to true if the task has a description.

completedDateTime

string(date-time)

Completed Date Time

The datetime the task was completed.

referenceCount

integer(int32)

Reference Count

The number of external references that exist on the task.

id

string

Id

The id of the task.

 

CreatedBy

Summary: Created By

Description:

 

          Properties:

Name

Type

Summary

user

User

User

 

 

User

Summary: User

Description:

 

          Properties:

Name

Type

Summary

displayName

string

Display Name

The display name of the user who created this task.

id

string

Id

The id of the user who created this task.

 


 

GetTask_Response_V2

Summary:

Description:

 

          Properties:

Name

Type

Summary

createdBy

CreatedBy

Created By

 

planId

string

Plan Id

The id of the plan this task belongs to.

bucketId

string

Bucket Id

The id of the bucket this task belongs to.

title

string

Title

The title of the task.

percentComplete

integer(int32)

Percent Complete

The completion percentage of the task.

startDateTime

string(date-time)

Start Date Time

The start datetime of the task.

createdDateTime

string(date-time)

Created Date Time

The datetime the task was created.

dueDateTime

string(date-time)

Due Date Time

The datetime the task is due.

hasDescription

boolean

Has Description

Set to true if the task has a description.

completedDateTime

string(date-time)

Completed Date Time

The datetime the task was completed.

referenceCount

integer(int32)

Reference Count

The number of external references that exist on the task.

id

string

Id

The id of the task.

appliedCategories

AppliedCategories

 

The categories to which the task has been applied.

_assignments

array of (_assignmentsItem)

assignments

 

 

CreatedBy

Summary: Created By

Description:

 

          Properties:

Name

Type

Summary

user

User

User

 

 

User

Summary: User

Description:

 

          Properties:

Name

Type

Summary

displayName

string

Display Name

The display name of the user who created this task.

id

string

Id

The id of the user who created this task.

 

_assignmentsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

userId

string

Assigned To User Id

The id of the user to whom this task was assigned to.

value

Value

 

 

 

Value

Summary:

Description:

 

          Properties:

Name

Type

Summary

assignedBy

AssignedBy

 

 

assignedDateTime

string(date-time)

Assigned Date Time

The datetime the task was assigned.

orderHint

string

Order Hint

Order Hint

 

AssignedBy

Summary:

Description:

 

          Properties:

Name

Type

Summary

user

User

 

 

 

User

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

Assigned By User Id

The id of the user who assigned this task.

 


 

GetTask_Response_V3

Summary:

Description:

 

          Properties:

Name

Type

Summary

createdBy

CreatedBy

Created By

 

planId

string

Plan Id

The id of the plan this task belongs to.

bucketId

string

Bucket Id

The id of the bucket this task belongs to.

title

string

Title

The title of the task.

percentComplete

integer(int32)

Percent Complete

The completion percentage of the task.

startDateTime

string(date-time)

Start Date Time

The start datetime of the task.

createdDateTime

string(date-time)

Created Date Time

The datetime the task was created.

dueDateTime

string(date-time)

Due Date Time

The datetime the task is due.

hasDescription

boolean

Has Description

Set to true if the task has a description.

completedDateTime

string(date-time)

Completed Date Time

The datetime the task was completed.

referenceCount

integer(int32)

Reference Count

The number of external references that exist on the task.

id

string

Id

The id of the task.

appliedCategories

AppliedCategories

 

The categories to which the task has been applied.

priority

integer(int32)

Priority

Priority of the task. Valid range of values is between 0 and 10 (inclusive), with increasing value being lower priority (0 has the highest priority and 10 has the lowest priority). Currently, Planner interprets values 0 and 1 as "urgent", 2 and 3 and 4 as "important", 5, 6, and 7 as "medium", and 8, 9, and 10 as "low". Currently, Planner sets the value 1 for "urgent", 3 for "important", 5 for "medium", and 9 for "low".

_assignments

array of (_assignmentsItem)

assignments

 

 

CreatedBy

Summary: Created By

Description:

 

          Properties:

Name

Type

Summary

user

User

User

 

 

User

Summary: User

Description:

 

          Properties:

Name

Type

Summary

displayName

string

Display Name

The display name of the user who created this task.

id

string

Id

The id of the user who created this task.

 

_assignmentsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

userId

string

Assigned To User Id

The id of the user to whom this task was assigned to.

value

Value

 

 

 

Value

Summary:

Description:

 

          Properties:

Name

Type

Summary

assignedBy

AssignedBy

 

 

assignedDateTime

string(date-time)

Assigned Date Time

The datetime the task was assigned.

orderHint

string

Order Hint

Order Hint

 

AssignedBy

Summary:

Description:

 

          Properties:

Name

Type

Summary

user

User

 

 

 

User

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

Assigned By User Id

The id of the user who assigned this task.

 


 

ListBuckets_Response

Summary:

Description:

 

          Properties:

Name

Type

Summary

value

array of (ValueItem)

value

 

 

ValueItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

name

string

Name

The name of the bucket.

planId

string

Plan Id

The id of the plan this bucket belongs to.

id

string

Id

The id of the bucket.

 


 

ListGroups_Response

Summary:

Description:

 

          Properties:

Name

Type

Summary

value

array of (ValueItem)

 

value

 

ValueItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

Group Id

Unique identifier of the group.

displayName

string

Name

O365 group name.

 


 

ListMyPlans_Response

Summary:

Description:

 

          Properties:

Name

Type

Summary

value

array of (ValueItem)

value

 

 

ValueItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

title

string

Title

The title of the Plan.

id

string

Id

The id of the plan.

 


 

ListTasks_Response

Summary:

Description:

 

          Properties:

Name

Type

Summary

value

array of (ValueItem)

value

 

 

ValueItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

createdBy

CreatedBy

Created By

 

completedBy

CompletedBy

Completed By

Information about who completed the task

planId

string

Plan Id

The id of the plan this task belongs to.

bucketId

string

Bucket Id

The id of the bucket this task belongs to.

title

string

Title

The title of the task.

percentComplete

integer(int32)

Percent Complete

The completion percentage of the task.

startDateTime

string(date-time)

Start Date Time

The start datetime of the task.

createdDateTime

string(date-time)

Created Date Time

The datetime the task was created.

dueDateTime

string(date-time)

Due Date Time

The datetime the task is due.

hasDescription

boolean

Has Description

Set to True if the task has a description.

completedDateTime

string(date-time)

Completed Date Time

The date time that the task was completed.

referenceCount

integer(int32)

Reference Count

The number of external references that exist on the task.

id

string

Id

The id of the task.

 

CreatedBy

Summary: Created By

Description:

 

          Properties:

Name

Type

Summary

user

User

User

 

 

User

Summary: User

Description:

 

          Properties:

Name

Type

Summary

displayName

string

Created by Display Name

The display name of the user who created this task.

id

string

Id

The id of the user who created this task.

 

CompletedBy

Summary: Completed By

Description: Information about who completed the task

 

          Properties:

Name

Type

Summary

user

User

user

user

 

User

Summary: user

Description: user

 

          Properties:

Name

Type

Summary

displayName

string

Completed By Display Name

displayName

id

string

id

id

 


 

ListTasks_Response_V2

Summary:

Description:

 

          Properties:

Name

Type

Summary

value

array of (GetTask_Response_V2)

value

 

@odata.nextLink

string

Next link

Link to get next page of results


 

UnassignUsersParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

assignments

string

Remove assigned users

Semi-colon seperated ids or email addresses of users who should be unassigned to this task.


 

UpdateTaskDetails_Request

Summary:

Description:

 

          Properties:

Name

Type

Summary

description

string

Description

The description of the task.

references

array of (ReferencesItem)

References

The collection of references on the task

checklist

array of (ChecklistItem)

Checklist

The collection of checklist items on the task

 

ReferencesItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

alias

string

Alias

A name alias to describe the reference.

resourceLink

string(uri)

Resource link

A valid URL based on the HTTP/HTTPS protocols.

type

Type

Type of the reference

Used to describe the type of the reference.  Values: [PowerPoint, Word, Excel, OneNote, Project, Visio, Pdf, Other]

 

Type

Summary: Type of the reference

Description: Used to describe the type of the reference.

 

          Properties:

Name

Type

Summary

 

ChecklistItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

Id

A number representing the checklist item.

title

string

Title

The name of the checklist item.

isChecked

boolean

Is Checked

Whether or not the item is checked.

 


 

UpdateTask_Request

Summary:

Description:

 

          Properties:

Name

Type

Summary

title

string

Title

The title of the plan.

dueDateTime

string(date-time)

Due Date-Time

The datetime the task is due (Ex. '2018-04-13T00:42:19.284Z').

startDateTime

string(date-time)

Start Date-Time

The datetime the task starts (Ex. '2018-04-13T00:42:19.284Z').

percentComplete

string

Progress

The progress of the task.  Values: [Not Started, In Progress, Completed]

assignments

string

Assisgned User Id

The id or email address of the user to assign this task to.


 

UpdateTask_Request_V2

Summary:

Description:

 

          Properties:

Name

Type

Summary

title

string

Title

The title of the plan.

dueDateTime

string(date-time)

Due Date-Time

The datetime the task is due (Ex. '2018-04-13T00:42:19.284Z').

startDateTime

string(date-time)

Start Date-Time

The datetime the task starts (Ex. '2018-04-13T00:42:19.284Z').

percentComplete

string

Progress

The progress of the task.  Values: [Not Started, In Progress, Completed]

assignments

string

Add assigned users

Semi-colon seperated ids or email addresses of users who should be assigned to this task.

unassignedUsers

string

Remove assigned users

Semi-colon seperated ids or email addresses of users who should be unassigned from this task.


 

UpdateTask_Request_V3

Summary:

Description:

 

          Properties:

Name

Type

Summary

title

string

Title

The title of the plan (maximum of 255 chars).

dueDateTime

string(date-time)

Due Date-Time

The datetime the task is due (Ex. '2018-04-13T00:42:19.284Z').

startDateTime

string(date-time)

Start Date-Time

The datetime the task starts (Ex. '2018-04-13T00:42:19.284Z').

percentComplete

integer(int32)

Percent Complete

The completion percentage of the task.

bucketId

string

Bucket Id

The bucket to place this task in.

appliedCategories

AppliedCategories

 

The categories to which the task has been applied.