What is the Developer API?
The Developer API lets external tools and systems connect to Planally to read or update your data — things like syncing project status into another tool, or pulling activity information into a report.
It's designed for integrations: connecting Planally to something else your organisation uses. It is not the API that powers the Planally web app itself.
To get started, you need an API key. Contact the Planally team at support@planally.com and they'll set one up for you.
API_KEY="pk_live_..."
BASE="https://your-ppms-instance.example.com/developer/v1"
# Who am I?
curl -s -H "Authorization: Bearer $API_KEY" "$BASE/me"
# List workflows I can access
curl -s -H "Authorization: Bearer $API_KEY" "$BASE/workflows"
# List projects under a workflow
curl -s -H "Authorization: Bearer $API_KEY" \
"$BASE/projects?workflowId=dd36407c-e43d-4838-ea2f-08ded0fe5d37"
# List activities under a project
curl -s -H "Authorization: Bearer $API_KEY" "$BASE/activities?projectId=1"
# Update an activity's planned start date (requires a Read & write key)
curl -s -X PATCH -H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"plannedStartDate": "2026-05-01T00:00:00Z"}' \
"$BASE/activities/20"