

planner¶

The ability to manage plans and tasks in Planner is a capability introduced in version 1.2.4 of @pnp/graph. Through the methods described you can add, update and delete items in Planner.

Get Plans by Id¶

Using the planner.plans.getById() you can get a specific Plan. Planner.plans is not an available endpoint, you need to get a specific Plan.

import { graph } from "@pnp/graph";

const plan = await graph.planner.plans.getById('planId');

Add new Plan¶

Using the planner.plans.add() you can create a new Plan.

import { graph } from "@pnp/graph";

const newPlan = await graph.planner.plans.add('groupObjectId', 'title');

Get Tasks in Plan¶

Using the tasks() you can get the Tasks in a Plan.

import { graph } from "@pnp/graph";

const planTasks = await graph.planner.plans.getById('planId').tasks.get();

Get Buckets in Plan¶

Using the buckets() you can get the Buckets in a Plan.

import { graph } from "@pnp/graph";

const planBuckets = await graph.planner.plans.getById('planId').buckets.get();

Get Details in Plan¶

Using the details() you can get the details in a Plan.

import { graph } from "@pnp/graph";

const planDetails = await graph.planner.plans.getById('planId').details.get();

Delete Plan¶

Using the delete() you can get delete a Plan.

import { graph } from "@pnp/graph";

const delPlan = await graph.planner.plans.getById('planId').delete();

Update Plan¶

Using the update() you can get update a Plan.

import { graph } from "@pnp/graph";

const updPlan = await graph.planner.plans.getById('planId').update({title: 'New Title'});

Get Task by Id¶

Using the planner.tasks.getById() you can get a specific Task. Planner.tasks is not an available endpoint, you need to get a specific Task.

import { graph } from "@pnp/graph";

const task = await graph.planner.tasks.getById('taskId');

Add new Task¶

Using the planner.tasks.add() you can create a new Task.

import { graph } from "@pnp/graph";

const newTask = await graph.planner.tasks.add('planId', 'title');

Get Details in Task¶

Using the details() you can get the details in a Task.

import { graph } from "@pnp/graph";

const taskDetails = await graph.planner.tasks.getById('taskId').details.get();

Delete Task¶

Using the delete() you can get delete a Task.

import { graph } from "@pnp/graph";

const delTask = await graph.planner.tasks.getById('taskId').delete();

Update Task¶

Using the update() you can get update a Task.

import { graph } from "@pnp/graph";

const updTask = await graph.planner.tasks.getById('taskId').update({properties});

Get Buckets by Id¶

Using the planner.buckets.getById() you can get a specific Bucket. planner.buckets is not an available endpoint, you need to get a specific Bucket.

import { graph } from "@pnp/graph";

const bucket = await graph.planner.buckets.getById('bucketId');

Add new Bucket¶

Using the planner.buckets.add() you can create a new Bucket.

import { graph } from "@pnp/graph";

const newBucket = await graph.planner.buckets.add('name', 'planId');

Update Bucket¶

Using the update() you can get update a Bucket.

import { graph } from "@pnp/graph";

const updBucket = await graph.planner.buckets.getById('bucketId').update({name: "Name"});

Delete Bucket¶

Using the delete() you can get delete a Bucket.

import { graph } from "@pnp/graph";

const delBucket = await graph.planner.buckets.getById('bucketId').delete();

Get Bucket Tasks¶

Using the tasks() you can get Tasks in a Bucket.

import { graph } from "@pnp/graph";

const bucketTasks = await graph.planner.buckets.getById('bucketId').tasks.get();