update_plan_details.py

"""
Update planner plan details (category descriptions, sharing).

Category descriptions label the 25 color categories available for tasks
in the plan (e.g. category1 → "Urgent", category2 → "Client work").

Requires delegated permission ``Group.ReadWrite.All``.

https://learn.microsoft.com/en-us/graph/api/planner-update-plandetails?view=graph-rest-1.0
"""

import sys

from office365.graph_client import GraphClient
from tests import test_client_id, test_password, test_tenant, test_username

client = GraphClient(tenant=test_tenant).with_username_and_password(test_client_id, test_username, test_password)

group = client.groups.get_by_name("My Sample Team").get().execute_query()
plans = group.planner.plans.get().execute_query()
if len(plans) == 0:
    sys.exit("No plans were found")

plan = plans[0]
details = plan.details.get().execute_query()
details.set_property(
    "categoryDescriptions",
    {
        "category1": "Urgent",
        "category2": "Client work",
        "category3": "Internal",
    },
).update().execute_query()
print("Plan details updated — categories set: Urgent, Client work, Internal")