Ontwikkelaars

Bouwen met Planitude

Een REST-API, ondertekende webhooks en een MCP-server: houd je systemen in lijn met de planning, reageer op elke wijziging en laat een AI-assistent aan je projecten werken.

Code, veldnamen en de technische referentie zijn in het Engels, zoals in de meeste API-documentatie.

Basis-URL: https://planitude.app

Verzoeken en antwoorden zijn JSON over HTTPS. Duur en vertraging zijn in werkminuten (een werkdag van 8 uur is 480), tijdstippen ISO 8601 in UTC, datums zonder tijd YYYY-MM-DD.

Verzoek
curl https://planitude.app/api/auth/me \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "user": {
    "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "email": "anna@example.com",
    "name": "Anna Rossi",
    "avatarUrl": null,
    "locale": "en",
    "emailVerified": true
  }
}

Snelstart

Van nul naar je eerste webhook in drie stappen. Je hebt alleen een terminal nodig.

  1. Maak een API-sleutel

    Open Profiel → API-sleutels, kies Lezen en schrijven en kopieer de sleutel: hij begint met pln_ en wordt maar één keer getoond. Bewaar hem in een omgevingsvariabele.

  2. Doe je eerste aanroep

    Toon de projecten die je ziet. De sleutel handelt als jou: dezelfde projecten, dezelfde rollen.

  3. Ontvang een webhook

    Abonneer een openbaar HTTPS-endpoint op de events die je nodig hebt, stuur meteen een testevent en controleer de handtekening.

1Terminal
export PLANITUDE_API_KEY="pln_…"
2
curl https://planitude.app/api/projects \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Verwacht resultaat200 OK
{
  "projects": [
    {
      "id": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
      "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
      "key": "WHX",
      "keyLocked": false,
      "name": "Warehouse expansion",
      "description": null,
      "startDate": "2026-10-05",
      "calendarId": null,
      "currency": "EUR",
      "scheduleFrom": "forward",
      "deadline": null,
      "color": null,
      "settings": {},
      "archivedAt": null,
      "createdBy": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "createdAt": "2026-10-01T08:30:12.418Z",
      "updatedAt": "2026-10-01T08:30:12.418Z",
      "workspaceName": "Acme Construction",
      "role": "owner",
      "taskCount": 12,
      "finishAt": "2026-10-07T15:00:00.000Z"
    }
  ]
}
3
curl -X POST https://planitude.app/api/webhooks \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com/hooks/planitude",
  "events": [
    "task.created",
    "task.completed"
  ],
  "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8"
}'
Voorbeeldpayloadwebhook.ping
{
  "id": "6f1c1d1e-2f4b-4d0a-9a77-2a3c5b1e9f10",
  "type": "webhook.ping",
  "apiVersion": "2026-10-01",
  "createdAt": "2026-10-01T08:30:12.418Z",
  "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
  "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
  "actor": {
    "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "name": "Anna Rossi"
  },
  "data": {
    "message": "Planitude webhook test",
    "webhook": {
      "id": "1747ee7f-a395-4d3c-94b0-54b513d71d88",
      "name": "Warehouse sync",
      "events": [
        "task.created",
        "task.completed"
      ]
    }
  }
}

Authenticatie

Authenticeer elk verzoek met een persoonlijke API-sleutel in de header Authorization, als bearer token. Sleutels zijn persoonlijk: ze handelen als jou, met jouw rol in elk project, nooit meer. Je kunt een sleutel beperken tot één workspace, een vervaldatum geven en op elk moment intrekken; elke aanroep wordt bij de sleutel gelogd.

Scopes

ScopeStaat toe
readplanitude:readProjecten, taken, afhankelijkheden, leden, opmerkingen, basislijnen en webhooks lezen.
writeplanitude:writeAlles van lezen, plus projecten, taken, afhankelijkheden, opmerkingen, basislijnen en webhooks aanmaken en wijzigen.

Sleutels en OAuth-apps kunnen geen projecten of taken verwijderen: verwijderen blijft in de web-app, waar een persoon het bevestigt. Een script met het verkeerde id kan geen planning wissen.

OAuth 2.1 voor apps van derden

Apps die namens andere mensen handelen, gebruiken OAuth 2.1: authorization code met PKCE (S256), refresh tokens die bij elk gebruik roteren, dynamische clientregistratie (RFC 7591). Vraag de resource https://planitude.app/api en de scope planitude:read of planitude:write.

De endpoints staan in de standaard discovery-documenten, zodat OAuth-bibliotheken zichzelf configureren.

  • https://planitude.app/.well-known/oauth-authorization-server
  • https://planitude.app/.well-known/oauth-protected-resource

Goede gewoonten

  • Bewaar sleutels in omgevingsvariabelen of een secretmanager, nooit in code of in een repository. Sleutels beginnen met pln_, zodat secretscanners ze herkennen.
  • Gebruik een sleutel met alleen leesrecht als je alleen leest, en één sleutel per integratie: dan trek je er één in zonder de andere te stoppen.
  • Geef sleutels voor scripts een vervaldatum en vervang ze regelmatig.
  • Roep de API aan vanaf je server, niet vanuit een browser: een sleutel in frontendcode is een openbare sleutel.
Bearercurl
curl https://planitude.app/api/projects \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
OAuth 2.1/.well-known/oauth-authorization-server
{
  "issuer": "https://planitude.app",
  "authorization_endpoint": "https://planitude.app/oauth/authorize",
  "token_endpoint": "https://planitude.app/api/oauth/token",
  "registration_endpoint": "https://planitude.app/api/oauth/register",
  "revocation_endpoint": "https://planitude.app/api/oauth/revoke",
  "scopes_supported": [
    "planitude:read",
    "planitude:write"
  ],
  "grant_types_supported": [
    "authorization_code",
    "refresh_token"
  ],
  "code_challenge_methods_supported": [
    "S256"
  ]
}

Fouten

Planitude gebruikt de standaard HTTP-statuscodes. Fouten hebben altijd dezelfde JSON-vorm: een stabiele error-code om op te beslissen en, waar nuttig, details met de reden of de velden die je moet verbeteren.

StatusBetekenis
400invalid_requestHet verzoek is ongeldig: details.fields noemt elk veld met het probleem.
401unauthorizedDe sleutel ontbreekt, is ongeldig, ingetrokken of verlopen.
403forbiddenDe sleutel of je rol staat het niet toe (details.reason), bijvoorbeeld schrijven met een sleutel met alleen leesrecht, of verwijderen.
404not_foundNiet gevonden, of niet zichtbaar voor jou.
409dependency_cycleConflict met de planning, bijvoorbeeld een afhankelijkheid die een kringloop zou sluiten (dependency_cycle).
429rate_limitedTe veel verzoeken: wacht het aantal seconden uit Retry-After.
500server_errorFout aan onze kant: probeer opnieuw met exponentiële wachttijd.

Error

VeldTypeBeschrijving
error
verplicht
stringStable error code: invalid_request, unauthorized, forbidden, not_found, conflict, dependency_cycle, limit_exceeded, rate_limited, server_error, ...
detailsobject
Antwoord
{
  "error": "invalid_request",
  "details": {
    "fields": [
      {
        "path": "name",
        "message": "Invalid input: expected string, received undefined"
      },
      {
        "path": "durationMin",
        "message": "Too small: expected number to be >=0"
      }
    ]
  }
}

Rate limits

Limieten gelden per sleutel, in een schuivend venster van één minuut: 240 leesverzoeken en 60 schrijfverzoeken. Daarboven krijg je 429 rate_limited met de header Retry-After, in seconden.

Wacht Retry-After af voordat je het opnieuw probeert, spreid bulkwerk in de tijd en bundel veel wijzigingen in één change set: tot 1.000 wijzigingen in één verzoek en één herberekening.

AntwoordHTTP
HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

{
  "error": "rate_limited",
  "details": {
    "retryAfterSec": 12
  }
}

Paginering en zoeken

Takenlijsten worden gepagineerd met een cursor. Geef limit mee (1–500, standaard 100) en voor de volgende pagina de nextCursor van het vorige antwoord als cursor. Is nextCursor gelijk aan null, dan zijn er geen pagina’s meer.

Filter met externalId (exacte overeenkomst met je eigen id), q (naam bevat), updatedSince en completed; sorteer met sort=-number (nieuwste eerst) of -updatedAt. Kortere lijsten, zoals projecten, leden en afhankelijkheden, komen volledig in één antwoord.

Verzoek
curl "https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks?limit=500" \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"

# next page: pass the nextCursor of the previous response
curl "https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks?limit=500&cursor=$NEXT_CURSOR" \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"

Versies

De API en de webhookpayloads hebben versies op datum. De huidige versie is 2026-10-01: het veld apiVersion van elk event en de info.version van het OpenAPI-document.

Binnen een versie voegen we alleen toe: nieuwe endpoints, nieuwe optionele velden, nieuwe eventtypen. Velden worden nooit verwijderd of van type veranderd zonder nieuwe versie, dus negeer velden die je niet kent.

Verzoek
curl https://planitude.app/api/webhooks/events
Antwoord200 OK
{
  "apiVersion": "2026-10-01",
  "events": [
    "project.created",
    "project.updated",
    "project.deleted",
    "task.created",
    "task.updated",
    "task.deleted",
    "task.completed",
    "task.dates_changed",
    "dependency.created",
    "dependency.deleted",
    "baseline.saved",
    "member.invited",
    "member.joined",
    "comment.created"
  ]
}

API-referentie

Account

Who is calling, and their workspaces.

User

Attributen

VeldTypeBeschrijving
idstring (uuid)
emailstring (email)
namestringkan null zijn
avatarUrlstringkan null zijn
localestring
emailVerifiedboolean
ObjectenUser
{
  "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
  "email": "anna@example.com",
  "name": "Anna Rossi",
  "avatarUrl": null,
  "locale": "en",
  "emailVerified": true
}

Workspace

Attributen

VeldTypeBeschrijving
idstring (uuid)
namestring
rolestring

Een van: owner, admin, member

ObjectenWorkspace
{
  "id": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
  "name": "Acme Construction",
  "role": "owner"
}

Current user (connection test)

GET/api/auth/me

Sleutel met leesrecht

Geeft terug

200 OK The user

VeldTypeBeschrijving
userUser
Verzoek
curl https://planitude.app/api/auth/me \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "user": {
    "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "email": "anna@example.com",
    "name": "Anna Rossi",
    "avatarUrl": null,
    "locale": "en",
    "emailVerified": true
  }
}

Workspaces of the user, with role

GET/api/workspaces

Sleutel met leesrecht

Geeft terug

200 OK Workspaces

VeldTypeBeschrijving
workspacesarray of Workspace
Verzoek
curl https://planitude.app/api/workspaces \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "workspaces": [
    {
      "id": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
      "name": "Acme Construction",
      "role": "owner"
    }
  ]
}

API-referentie

Projects

Projects, templates and baselines.

Project

A project as returned by the write endpoints and project listings.

Attributen

VeldTypeBeschrijving
idstring (uuid)
workspaceIdstring (uuid)
keystringProject key, e.g. CRON (task keys are CRON-12).
keyLockedboolean
namestring
descriptionstringkan null zijn
startDatestring (date)
calendarIdstring (uuid)kan null zijn
currencystring
scheduleFromstring

Een van: forward, backward

deadlinestring (date)kan null zijn
colorstringkan null zijn
settingsobject
archivedAtstring (date-time)kan null zijn
createdBystring (uuid)kan null zijn
createdAtstring (date-time)
updatedAtstring (date-time)
ObjectenProject
{
  "id": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
  "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
  "key": "WHX",
  "keyLocked": false,
  "name": "Warehouse expansion",
  "description": null,
  "startDate": "2026-10-05",
  "calendarId": null,
  "currency": "EUR",
  "scheduleFrom": "forward",
  "deadline": null,
  "color": null,
  "settings": {},
  "archivedAt": null,
  "createdBy": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
  "createdAt": "2026-10-01T08:30:12.418Z",
  "updatedAt": "2026-10-01T08:30:12.418Z"
}

Template

Attributen

VeldTypeBeschrijving
idstringbuiltin:<slug> or the id of a template saved by you.
kindstring

Een van: builtin, user

namestring
descriptionstringkan null zijn
taskCountinteger
durationDaysintegerWorking days from start to finish.
ObjectenTemplate
{
  "id": "builtin:website-launch",
  "kind": "builtin",
  "name": "Website launch",
  "description": "From discovery to go-live: design, content, development, testing and launch.",
  "taskCount": 12,
  "durationDays": 43
}

Baseline

Attributen

VeldTypeBeschrijving
idstring (uuid)
namestring
indexintegerkan null zijnNumbered MS Project baseline (1-10); null for the main baseline and the ones you name.
capturedAtstring (date-time)
capturedBystring (uuid)kan null zijn
taskCountinteger
ObjectenBaseline
{
  "id": "b5d68d05-0640-48f9-8eeb-ed7804f4a116",
  "name": "Plan v1",
  "index": null,
  "capturedAt": "2026-10-01T08:30:12.418Z",
  "capturedBy": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
  "taskCount": 12
}

List projects

GET/api/projects

Sleutel met leesrecht

All projects visible to the user (not paginated). ?archived=1 includes archived ones.

Queryparameters

VeldTypeBeschrijving
archivedstring

Een van: 1

Geeft terug

200 OK Projects

VeldTypeBeschrijving
projectsarray of Project
Verzoek
curl https://planitude.app/api/projects \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "projects": [
    {
      "id": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
      "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
      "key": "WHX",
      "keyLocked": false,
      "name": "Warehouse expansion",
      "description": null,
      "startDate": "2026-10-05",
      "calendarId": null,
      "currency": "EUR",
      "scheduleFrom": "forward",
      "deadline": null,
      "color": null,
      "settings": {},
      "archivedAt": null,
      "createdBy": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "createdAt": "2026-10-01T08:30:12.418Z",
      "updatedAt": "2026-10-01T08:30:12.418Z",
      "workspaceName": "Acme Construction",
      "role": "owner",
      "taskCount": 12,
      "finishAt": "2026-10-07T15:00:00.000Z"
    }
  ]
}

Create a project

POST/api/projects

Sleutel met schrijfrecht

Request-body

VeldTypeBeschrijving
name
verplicht
string
workspaceIdstring (uuid)Defaults to your personal workspace.
keystring2-5 letters/digits, starts with a letter. Derived from the name if omitted.
descriptionstringkan null zijn
startDatestring (date)
deadlinestring (date)kan null zijn
currencystring
scheduleFromstring

Een van: forward, backward

colorstringkan null zijn

Geeft terug

201 Created Created

VeldTypeBeschrijving
projectProject
Verzoek
curl -X POST https://planitude.app/api/projects \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Warehouse expansion","startDate":"2026-10-05","currency":"EUR"}'
Antwoord201 Created
{
  "project": {
    "id": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
    "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
    "key": "WHX",
    "keyLocked": false,
    "name": "Warehouse expansion",
    "description": null,
    "startDate": "2026-10-05",
    "calendarId": null,
    "currency": "EUR",
    "scheduleFrom": "forward",
    "deadline": null,
    "color": null,
    "settings": {},
    "archivedAt": null,
    "createdBy": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "createdAt": "2026-10-01T08:30:12.418Z",
    "updatedAt": "2026-10-01T08:30:12.418Z"
  }
}

Create a project from a template

POST/api/projects/from-template

Sleutel met schrijfrecht

Request-body

VeldTypeBeschrijving
templateId
verplicht
stringId from GET /api/templates.
startDate
verplicht
string (date)
namestring
keystring
localestringLanguage of the template texts (en, it, es, fr, de, pt, nl, pl, ja, zh, sv, da, no, fi, cs, ro, uk, tr, ar, he, hi, id, vi, ko).
tzstringIANA time zone of the project calendar.
workspaceIdstring (uuid)

Geeft terug

201 Created Created

VeldTypeBeschrijving
projectProject
taskCountinteger
conflictsarray of Conflict
Verzoek
curl -X POST https://planitude.app/api/projects/from-template \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "templateId": "builtin:website-launch",
  "startDate": "2026-10-05",
  "name": "Website relaunch",
  "locale": "en"
}'
Antwoord201 Created
{
  "project": {
    "id": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
    "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
    "key": "WHX",
    "keyLocked": false,
    "name": "Warehouse expansion",
    "description": null,
    "startDate": "2026-10-05",
    "calendarId": null,
    "currency": "EUR",
    "scheduleFrom": "forward",
    "deadline": null,
    "color": null,
    "settings": {},
    "archivedAt": null,
    "createdBy": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "createdAt": "2026-10-01T08:30:12.418Z",
    "updatedAt": "2026-10-01T08:30:12.418Z"
  },
  "taskCount": 12,
  "conflicts": []
}

List project templates

GET/api/templates

Sleutel met leesrecht

Queryparameters

VeldTypeBeschrijving
localestring

Geeft terug

200 OK Templates

VeldTypeBeschrijving
templatesarray of Template
Verzoek
curl https://planitude.app/api/templates \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "templates": [
    {
      "id": "builtin:website-launch",
      "kind": "builtin",
      "name": "Website launch",
      "description": "From discovery to go-live: design, content, development, testing and launch.",
      "taskCount": 12,
      "durationDays": 43
    }
  ]
}

Full project (tasks tree, dependencies, resources, members, baselines)

GET/api/projects/{projectId}

Sleutel met leesrecht

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.

Geeft terug

200 OK Project

VeldTypeBeschrijving
projectProject
tasksarray of Task
dependenciesarray of Dependency
Verzoek
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8 \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "project": {
    "id": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
    "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
    "key": "WHX",
    "keyLocked": false,
    "name": "Warehouse expansion",
    "description": null,
    "startDate": "2026-10-05",
    "calendarId": null,
    "currency": "EUR",
    "scheduleFrom": "forward",
    "deadline": null,
    "color": null,
    "settings": {},
    "archivedAt": null,
    "createdBy": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "createdAt": "2026-10-01T08:30:12.418Z",
    "updatedAt": "2026-10-01T08:30:12.418Z"
  },
  "tasks": [
    {
      "id": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "number": 1,
      "key": "WHX-1",
      "parentId": null,
      "sortKey": "i",
      "name": "Foundations",
      "type": "task",
      "durationMin": 1440,
      "workMin": 0,
      "progressPct": 0,
      "constraintKind": "asap",
      "constraintDate": null,
      "deadline": null,
      "calendarId": null,
      "costFixed": 0,
      "notes": null,
      "color": null,
      "wbs": null,
      "externalId": "crm-4711",
      "startAt": "2026-10-05T06:00:00.000Z",
      "finishAt": "2026-10-07T15:00:00.000Z",
      "isCritical": true,
      "totalFloatMin": 0,
      "earlyStartAt": "2026-10-05T06:00:00.000Z",
      "lateFinishAt": "2026-10-07T15:00:00.000Z",
      "actualStartAt": null,
      "actualFinishAt": null,
      "actualDurationMin": null,
      "remainingDurationMin": null,
      "manuallyScheduled": false,
      "levelingDelayMin": 0,
      "taskType": "fixed_units",
      "effortDriven": false,
      "durationOptimisticMin": null,
      "durationPessimisticMin": null
    }
  ],
  "dependencies": [
    {
      "id": "9ba5faf8-923d-4ecc-86f0-f245c5d179db",
      "predecessorId": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "successorId": "a22fd799-c4dc-4869-a466-0dd6e96f71ce",
      "type": "FS",
      "lagMin": 0
    }
  ]
}

Update a project

PATCH/api/projects/{projectId}

Sleutel met schrijfrecht

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.

Request-body

VeldTypeBeschrijving
namestring
descriptionstringkan null zijn
startDatestring (date)
deadlinestring (date)kan null zijn
currencystring
scheduleFromstring

Een van: forward, backward

colorstringkan null zijn
archivedboolean

Geeft terug

200 OK Updated

VeldTypeBeschrijving
projectProject
conflictsarray of Conflict
rescheduledbooleanThe schedule was recalculated (start date, calendar or direction changed).
Verzoek
curl -X PATCH https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8 \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deadline":"2026-12-18"}'
Antwoord200 OK
{
  "project": {
    "id": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
    "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
    "key": "WHX",
    "keyLocked": false,
    "name": "Warehouse expansion",
    "description": null,
    "startDate": "2026-10-05",
    "calendarId": null,
    "currency": "EUR",
    "scheduleFrom": "forward",
    "deadline": null,
    "color": null,
    "settings": {},
    "archivedAt": null,
    "createdBy": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "createdAt": "2026-10-01T08:30:12.418Z",
    "updatedAt": "2026-10-01T08:30:12.418Z"
  },
  "conflicts": [],
  "rescheduled": false
}

Export the plan as a file (Microsoft Project XML, CSV, PNG or PDF)

GET/api/projects/{projectId}/export

Sleutel met leesrecht

Returns the file itself (Content-Disposition: attachment), not JSON. Any role with access to the project, read-only included. png and pdf draw the Gantt chart on the server (title, generation date, legend; in the PDF repeated on every page) and accept the image options below; at most 20 image exports per user every 10 minutes. Over the size limits: 413 limit_exceeded with details.reason (tasks, image_too_large, pages, timeline).

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.

Queryparameters

VeldTypeBeschrijving
formatstringFile format. mspdi = Microsoft Project XML.

Een van: mspdi, csv, png, pdf

Standaard: mspdi

localestringLanguage of headings, legend and dates (e.g. en, it, ar, ja).

Standaard: en

scalestringPNG/PDF: time unit of the columns.

Een van: auto, day, week, month, quarter

Standaard: auto

fromstring (date)PNG/PDF: first day to draw (with to). Default: the whole project.
tostring (date)PNG/PDF: last day to draw (with from).
criticalstringPNG/PDF: highlight the critical path.

Een van: 0, 1

Standaard: 1

baselinestringPNG/PDF: draw the main baseline under each bar.

Een van: 0, 1

Standaard: 1

linksstringPNG/PDF: draw dependency arrows.

Een van: 0, 1

Standaard: 1

paperstringPDF: paper size.

Een van: a4, a3, letter

Standaard: a4

orientationstringPDF: page orientation.

Een van: landscape, portrait

Standaard: landscape

Geeft terug

200 OK The file: `application/xml`, `text/csv`, `image/png` or `application/pdf`.

Verzoek
curl "https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/export?format=pdf&locale=en&paper=a4" \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -o plan.pdf

List baselines

GET/api/projects/{projectId}/baseline

Sleutel met leesrecht

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.

Geeft terug

200 OK Baselines

VeldTypeBeschrijving
baselinesarray of Baseline
Verzoek
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/baseline \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "baselines": [
    {
      "id": "b5d68d05-0640-48f9-8eeb-ed7804f4a116",
      "name": "Plan v1",
      "index": null,
      "capturedAt": "2026-10-01T08:30:12.418Z",
      "capturedBy": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "taskCount": 12
    }
  ]
}

Save a baseline

POST/api/projects/{projectId}/baseline

Sleutel met schrijfrecht

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.

Request-body

VeldTypeBeschrijving
namestring

Geeft terug

201 Created Saved

VeldTypeBeschrijving
baselineBaseline
Verzoek
curl -X POST https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/baseline \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Plan v1"}'
Antwoord201 Created
{
  "baseline": {
    "id": "b5d68d05-0640-48f9-8eeb-ed7804f4a116",
    "name": "Plan v1",
    "index": null,
    "capturedAt": "2026-10-01T08:30:12.418Z",
    "capturedBy": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "taskCount": 12
  }
}

API-referentie

Tasks

Tasks, search by external id, comments.

Task

Task representation of GET /tasks and webhook payloads: the stored task (without sortKey) plus project, assignees and link.

Attributen

VeldTypeBeschrijving
idstring (uuid)
numberintegerSequential number in the project, never reused.
keystringHuman key, e.g. CRON-12.
parentIdstring (uuid)kan null zijn
namestring
typestring

Een van: summary, task, milestone

durationMinintegerDuration in working minutes (8h day = 480).
workMininteger
progressPctnumber
constraintKindstring

Een van: asap, alap, start_no_earlier_than, start_no_later_than, finish_no_earlier_than, finish_no_later_than, must_start_on, must_finish_on

constraintDatestring (date-time)kan null zijn
deadlinestring (date-time)kan null zijn
calendarIdstring (uuid)kan null zijn
costFixednumber
notesstringkan null zijn
colorstringkan null zijn
wbsstringkan null zijn
externalIdstringkan null zijnYour identifier for this task in another system. Searchable with GET /tasks?externalId=.
startAtstring (date-time)kan null zijnComputed start.
finishAtstring (date-time)kan null zijnComputed finish.
isCriticalbooleanOn the critical path.
totalFloatMinintegerkan null zijnTotal float (slack) in working minutes.
earlyStartAtstring (date-time)kan null zijn
lateFinishAtstring (date-time)kan null zijn
actualStartAtstring (date-time)kan null zijn
actualFinishAtstring (date-time)kan null zijn
actualDurationMinintegerkan null zijn
remainingDurationMinintegerkan null zijn
manuallyScheduledboolean
levelingDelayMininteger
taskTypestring

Een van: fixed_units, fixed_duration, fixed_work, fixed_duration_and_units

effortDrivenboolean
durationOptimisticMinintegerkan null zijn
durationPessimisticMinintegerkan null zijn
projectIdstring (uuid)
completedbooleanprogressPct = 100.
assigneesarray of Assignee
urlstring (uri)Page of the task in the web app.
ObjectenTask
{
  "id": "4dbd104a-00cd-4035-8955-255f52ea586a",
  "number": 1,
  "key": "WHX-1",
  "parentId": null,
  "name": "Foundations",
  "type": "task",
  "durationMin": 1440,
  "workMin": 0,
  "progressPct": 0,
  "constraintKind": "asap",
  "constraintDate": null,
  "deadline": null,
  "calendarId": null,
  "costFixed": 0,
  "notes": null,
  "color": null,
  "wbs": null,
  "externalId": "crm-4711",
  "startAt": "2026-10-05T06:00:00.000Z",
  "finishAt": "2026-10-07T15:00:00.000Z",
  "isCritical": true,
  "totalFloatMin": 0,
  "earlyStartAt": "2026-10-05T06:00:00.000Z",
  "lateFinishAt": "2026-10-07T15:00:00.000Z",
  "actualStartAt": null,
  "actualFinishAt": null,
  "actualDurationMin": null,
  "remainingDurationMin": null,
  "manuallyScheduled": false,
  "levelingDelayMin": 0,
  "taskType": "fixed_units",
  "effortDriven": false,
  "durationOptimisticMin": null,
  "durationPessimisticMin": null,
  "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
  "completed": false,
  "assignees": [
    {
      "resourceId": "0c6a8f52-3d7e-4b19-9a4e-6f1d2c8b7e30",
      "userId": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "name": "Anna Rossi",
      "unitsPct": 100
    }
  ],
  "url": "https://planitude.app/app/t/WHX-1"
}

WriteResult

Attributen

VeldTypeBeschrijving
tasksarray of TaskCreated/updated tasks plus the ones the recalculation moved.
deletedTaskIdsarray of string
dependenciesarray of Dependency
deletedDependencyIdsarray of string
conflictsarray of Conflict
projectStartAtstring (date-time)
projectFinishAtstring (date-time)
statsobject
Velden van stats tonen
VeldTypeBeschrijving
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
ObjectenWriteResult
{
  "tasks": [
    {
      "id": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "number": 1,
      "key": "WHX-1",
      "parentId": null,
      "sortKey": "i",
      "name": "Foundations",
      "type": "task",
      "durationMin": 1440,
      "workMin": 0,
      "progressPct": 0,
      "constraintKind": "asap",
      "constraintDate": null,
      "deadline": null,
      "calendarId": null,
      "costFixed": 0,
      "notes": null,
      "color": null,
      "wbs": null,
      "externalId": "crm-4711",
      "startAt": "2026-10-05T06:00:00.000Z",
      "finishAt": "2026-10-07T15:00:00.000Z",
      "isCritical": true,
      "totalFloatMin": 0,
      "earlyStartAt": "2026-10-05T06:00:00.000Z",
      "lateFinishAt": "2026-10-07T15:00:00.000Z",
      "actualStartAt": null,
      "actualFinishAt": null,
      "actualDurationMin": null,
      "remainingDurationMin": null,
      "manuallyScheduled": false,
      "levelingDelayMin": 0,
      "taskType": "fixed_units",
      "effortDriven": false,
      "durationOptimisticMin": null,
      "durationPessimisticMin": null
    }
  ],
  "deletedTaskIds": [],
  "dependencies": [
    {
      "id": "9ba5faf8-923d-4ecc-86f0-f245c5d179db",
      "predecessorId": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "successorId": "a22fd799-c4dc-4869-a466-0dd6e96f71ce",
      "type": "FS",
      "lagMin": 0
    }
  ],
  "deletedDependencyIds": [],
  "conflicts": [],
  "projectStartAt": "2026-10-05T06:00:00.000Z",
  "projectFinishAt": "2026-10-07T15:00:00.000Z",
  "stats": {
    "taskCount": 12,
    "recomputedCount": 3,
    "savedCount": 2,
    "durationMs": 39
  }
}

Comment

Attributen

VeldTypeBeschrijving
idstring (uuid)
taskIdstring (uuid)
userIdstring (uuid)
authorNamestring
authorAvatarUrlstringkan null zijn
bodystring
mentionsarray of string
createdAtstring (date-time)
editedAtstring (date-time)kan null zijn
ObjectenComment
{
  "id": "0fc2dec5-a409-47c9-9c6e-0663e8f8bcf3",
  "taskId": "4dbd104a-00cd-4035-8955-255f52ea586a",
  "userId": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
  "authorName": "Anna Rossi",
  "authorAvatarUrl": null,
  "body": "Concrete delivered, we can start the walls.",
  "mentions": [],
  "createdAt": "2026-10-01T08:30:12.418Z",
  "editedAt": null
}

List or search tasks (paginated)

GET/api/projects/{projectId}/tasks

Sleutel met leesrecht

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.

Queryparameters

VeldTypeBeschrijving
limitinteger1-500.

Standaard: 100

cursorstringnextCursor of the previous page.
sortstring-number = newest first (polling triggers). -updatedAt returns the first page only.

Een van: number, -number, -updatedAt

Standaard: number

externalIdstringExact match on externalId.
qstringName contains (case-insensitive).
updatedSincestring (date-time)
completedstring

Een van: true, false

Geeft terug

200 OK A page of tasks

VeldTypeBeschrijving
tasksarray of Task
nextCursorstringkan null zijn
Verzoek
curl "https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks?externalId=crm-4711" \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "tasks": [
    {
      "id": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "number": 1,
      "key": "WHX-1",
      "parentId": null,
      "name": "Foundations",
      "type": "task",
      "durationMin": 1440,
      "workMin": 0,
      "progressPct": 0,
      "constraintKind": "asap",
      "constraintDate": null,
      "deadline": null,
      "calendarId": null,
      "costFixed": 0,
      "notes": null,
      "color": null,
      "wbs": null,
      "externalId": "crm-4711",
      "startAt": "2026-10-05T06:00:00.000Z",
      "finishAt": "2026-10-07T15:00:00.000Z",
      "isCritical": true,
      "totalFloatMin": 0,
      "earlyStartAt": "2026-10-05T06:00:00.000Z",
      "lateFinishAt": "2026-10-07T15:00:00.000Z",
      "actualStartAt": null,
      "actualFinishAt": null,
      "actualDurationMin": null,
      "remainingDurationMin": null,
      "manuallyScheduled": false,
      "levelingDelayMin": 0,
      "taskType": "fixed_units",
      "effortDriven": false,
      "durationOptimisticMin": null,
      "durationPessimisticMin": null,
      "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
      "completed": false,
      "assignees": [
        {
          "resourceId": "0c6a8f52-3d7e-4b19-9a4e-6f1d2c8b7e30",
          "userId": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
          "name": "Anna Rossi",
          "unitsPct": 100
        }
      ],
      "url": "https://planitude.app/app/t/WHX-1"
    }
  ],
  "nextCursor": null
}

Create a task, or apply a change set

POST/api/projects/{projectId}/tasks

Sleutel met schrijfrecht

Send a TaskCreate to create one task (201), or a ChangeSet to apply several changes in one transaction (200). Dates are recalculated by the scheduling engine.

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.

Request-body

TaskCreate

VeldTypeBeschrijving
name
verplicht
string
parentIdstring (uuid)kan null zijnParent (summary) task; null = top level.
afterTaskIdstring (uuid)kan null zijnInsert after this sibling.
beforeTaskIdstring (uuid)kan null zijnInsert before this sibling.
typestring

Een van: summary, task, milestone

durationMinintegerDuration in working minutes (8h day = 480).
workMininteger
progressPctnumber
constraintKindstring

Een van: asap, alap, start_no_earlier_than, start_no_later_than, finish_no_earlier_than, finish_no_later_than, must_start_on, must_finish_on

constraintDatestring (date-time)kan null zijn
deadlinestring (date-time)kan null zijn
calendarIdstring (uuid)kan null zijn
costFixednumber
notesstringkan null zijn
colorstringkan null zijn
wbsstringkan null zijn
externalIdstringkan null zijnYour identifier for this task in another system. Searchable with GET /tasks?externalId=.

of ChangeSet

VeldTypeBeschrijving
createTasksarray of TaskCreate
updateTasksarray of any
createDependenciesarray of DependencyCreate
deleteDependencyIdsarray of string
fullRescheduleboolean

Geeft terug

201 Created Task created

VeldTypeBeschrijving
tasksarray of TaskCreated/updated tasks plus the ones the recalculation moved.
deletedTaskIdsarray of string
dependenciesarray of Dependency
deletedDependencyIdsarray of string
conflictsarray of Conflict
projectStartAtstring (date-time)
projectFinishAtstring (date-time)
statsobject
Velden van stats tonen
VeldTypeBeschrijving
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Verzoek
curl -X POST https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Foundations","durationMin":1440,"externalId":"crm-4711"}'
Antwoord201 Created
{
  "tasks": [
    {
      "id": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "number": 1,
      "key": "WHX-1",
      "parentId": null,
      "sortKey": "i",
      "name": "Foundations",
      "type": "task",
      "durationMin": 1440,
      "workMin": 0,
      "progressPct": 0,
      "constraintKind": "asap",
      "constraintDate": null,
      "deadline": null,
      "calendarId": null,
      "costFixed": 0,
      "notes": null,
      "color": null,
      "wbs": null,
      "externalId": "crm-4711",
      "startAt": "2026-10-05T06:00:00.000Z",
      "finishAt": "2026-10-07T15:00:00.000Z",
      "isCritical": true,
      "totalFloatMin": 0,
      "earlyStartAt": "2026-10-05T06:00:00.000Z",
      "lateFinishAt": "2026-10-07T15:00:00.000Z",
      "actualStartAt": null,
      "actualFinishAt": null,
      "actualDurationMin": null,
      "remainingDurationMin": null,
      "manuallyScheduled": false,
      "levelingDelayMin": 0,
      "taskType": "fixed_units",
      "effortDriven": false,
      "durationOptimisticMin": null,
      "durationPessimisticMin": null
    }
  ],
  "deletedTaskIds": [],
  "dependencies": [
    {
      "id": "9ba5faf8-923d-4ecc-86f0-f245c5d179db",
      "predecessorId": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "successorId": "a22fd799-c4dc-4869-a466-0dd6e96f71ce",
      "type": "FS",
      "lagMin": 0
    }
  ],
  "deletedDependencyIds": [],
  "conflicts": [],
  "projectStartAt": "2026-10-05T06:00:00.000Z",
  "projectFinishAt": "2026-10-07T15:00:00.000Z",
  "stats": {
    "taskCount": 12,
    "recomputedCount": 3,
    "savedCount": 2,
    "durationMs": 39
  }
}

Get a task

GET/api/projects/{projectId}/tasks/{taskId}

Sleutel met leesrecht

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.
taskId
verplicht
string (uuid)Task id.

Geeft terug

200 OK The task

VeldTypeBeschrijving
taskTask
Verzoek
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks/4dbd104a-00cd-4035-8955-255f52ea586a \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "task": {
    "id": "4dbd104a-00cd-4035-8955-255f52ea586a",
    "number": 1,
    "key": "WHX-1",
    "parentId": null,
    "name": "Foundations",
    "type": "task",
    "durationMin": 1440,
    "workMin": 0,
    "progressPct": 0,
    "constraintKind": "asap",
    "constraintDate": null,
    "deadline": null,
    "calendarId": null,
    "costFixed": 0,
    "notes": null,
    "color": null,
    "wbs": null,
    "externalId": "crm-4711",
    "startAt": "2026-10-05T06:00:00.000Z",
    "finishAt": "2026-10-07T15:00:00.000Z",
    "isCritical": true,
    "totalFloatMin": 0,
    "earlyStartAt": "2026-10-05T06:00:00.000Z",
    "lateFinishAt": "2026-10-07T15:00:00.000Z",
    "actualStartAt": null,
    "actualFinishAt": null,
    "actualDurationMin": null,
    "remainingDurationMin": null,
    "manuallyScheduled": false,
    "levelingDelayMin": 0,
    "taskType": "fixed_units",
    "effortDriven": false,
    "durationOptimisticMin": null,
    "durationPessimisticMin": null,
    "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
    "completed": false,
    "assignees": [
      {
        "resourceId": "0c6a8f52-3d7e-4b19-9a4e-6f1d2c8b7e30",
        "userId": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
        "name": "Anna Rossi",
        "unitsPct": 100
      }
    ],
    "url": "https://planitude.app/app/t/WHX-1"
  }
}

Update a task

PATCH/api/projects/{projectId}/tasks/{taskId}

Sleutel met schrijfrecht

Only the fields you send change; null clears a field.

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.
taskId
verplicht
string (uuid)Task id.

Request-body

VeldTypeBeschrijving
namestring
typestring

Een van: summary, task, milestone

durationMinintegerDuration in working minutes (8h day = 480).
workMininteger
progressPctnumber
constraintKindstring

Een van: asap, alap, start_no_earlier_than, start_no_later_than, finish_no_earlier_than, finish_no_later_than, must_start_on, must_finish_on

constraintDatestring (date-time)kan null zijn
deadlinestring (date-time)kan null zijn
calendarIdstring (uuid)kan null zijn
costFixednumber
notesstringkan null zijn
colorstringkan null zijn
wbsstringkan null zijn
externalIdstringkan null zijnYour identifier for this task in another system. Searchable with GET /tasks?externalId=.
placementobject
Velden van placement tonen
VeldTypeBeschrijving
parentIdstring (uuid)kan null zijnParent (summary) task; null = top level.
afterTaskIdstring (uuid)kan null zijnInsert after this sibling.
beforeTaskIdstring (uuid)kan null zijnInsert before this sibling.

Geeft terug

200 OK Updated

VeldTypeBeschrijving
tasksarray of TaskCreated/updated tasks plus the ones the recalculation moved.
deletedTaskIdsarray of string
dependenciesarray of Dependency
deletedDependencyIdsarray of string
conflictsarray of Conflict
projectStartAtstring (date-time)
projectFinishAtstring (date-time)
statsobject
Velden van stats tonen
VeldTypeBeschrijving
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Verzoek
curl -X PATCH https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks/4dbd104a-00cd-4035-8955-255f52ea586a \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"progressPct":100}'
Antwoord200 OK
{
  "tasks": [
    {
      "id": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "number": 1,
      "key": "WHX-1",
      "parentId": null,
      "sortKey": "i",
      "name": "Foundations",
      "type": "task",
      "durationMin": 1440,
      "workMin": 0,
      "progressPct": 0,
      "constraintKind": "asap",
      "constraintDate": null,
      "deadline": null,
      "calendarId": null,
      "costFixed": 0,
      "notes": null,
      "color": null,
      "wbs": null,
      "externalId": "crm-4711",
      "startAt": "2026-10-05T06:00:00.000Z",
      "finishAt": "2026-10-07T15:00:00.000Z",
      "isCritical": true,
      "totalFloatMin": 0,
      "earlyStartAt": "2026-10-05T06:00:00.000Z",
      "lateFinishAt": "2026-10-07T15:00:00.000Z",
      "actualStartAt": null,
      "actualFinishAt": null,
      "actualDurationMin": null,
      "remainingDurationMin": null,
      "manuallyScheduled": false,
      "levelingDelayMin": 0,
      "taskType": "fixed_units",
      "effortDriven": false,
      "durationOptimisticMin": null,
      "durationPessimisticMin": null
    }
  ],
  "deletedTaskIds": [],
  "dependencies": [
    {
      "id": "9ba5faf8-923d-4ecc-86f0-f245c5d179db",
      "predecessorId": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "successorId": "a22fd799-c4dc-4869-a466-0dd6e96f71ce",
      "type": "FS",
      "lagMin": 0
    }
  ],
  "deletedDependencyIds": [],
  "conflicts": [],
  "projectStartAt": "2026-10-05T06:00:00.000Z",
  "projectFinishAt": "2026-10-07T15:00:00.000Z",
  "stats": {
    "taskCount": 12,
    "recomputedCount": 3,
    "savedCount": 2,
    "durationMs": 39
  }
}

Comments of a task

GET/api/projects/{projectId}/tasks/{taskId}/comments

Sleutel met leesrecht

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.
taskId
verplicht
string (uuid)Task id.

Geeft terug

200 OK Comments

VeldTypeBeschrijving
commentsarray of Comment
Verzoek
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks/4dbd104a-00cd-4035-8955-255f52ea586a/comments \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "comments": [
    {
      "id": "0fc2dec5-a409-47c9-9c6e-0663e8f8bcf3",
      "taskId": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "userId": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "authorName": "Anna Rossi",
      "authorAvatarUrl": null,
      "body": "Concrete delivered, we can start the walls.",
      "mentions": [],
      "createdAt": "2026-10-01T08:30:12.418Z",
      "editedAt": null
    }
  ]
}

Comment on a task

POST/api/projects/{projectId}/tasks/{taskId}/comments

Sleutel met schrijfrecht

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.
taskId
verplicht
string (uuid)Task id.

Request-body

VeldTypeBeschrijving
body
verplicht
stringPlain text.
mentionsarray of stringUser ids to notify.

Geeft terug

201 Created Created

VeldTypeBeschrijving
commentComment
Verzoek
curl -X POST https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks/4dbd104a-00cd-4035-8955-255f52ea586a/comments \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body":"Concrete delivered, we can start the walls."}'
Antwoord201 Created
{
  "comment": {
    "id": "0fc2dec5-a409-47c9-9c6e-0663e8f8bcf3",
    "taskId": "4dbd104a-00cd-4035-8955-255f52ea586a",
    "userId": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "authorName": "Anna Rossi",
    "authorAvatarUrl": null,
    "body": "Concrete delivered, we can start the walls.",
    "mentions": [],
    "createdAt": "2026-10-01T08:30:12.418Z",
    "editedAt": null
  }
}

API-referentie

Dependencies

Links between tasks (FS, SS, FF, SF, with lag).

Dependency

Attributen

VeldTypeBeschrijving
idstring (uuid)
predecessorIdstring (uuid)
successorIdstring (uuid)
typestring

Een van: FS, SS, FF, SF

lagMinintegerWorking minutes; negative = lead.
ObjectenDependency
{
  "id": "9ba5faf8-923d-4ecc-86f0-f245c5d179db",
  "predecessorId": "4dbd104a-00cd-4035-8955-255f52ea586a",
  "successorId": "a22fd799-c4dc-4869-a466-0dd6e96f71ce",
  "type": "FS",
  "lagMin": 0
}

List dependencies

GET/api/projects/{projectId}/dependencies

Sleutel met leesrecht

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.

Geeft terug

200 OK Dependencies

VeldTypeBeschrijving
dependenciesarray of Dependency
Verzoek
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/dependencies \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "dependencies": [
    {
      "id": "9ba5faf8-923d-4ecc-86f0-f245c5d179db",
      "predecessorId": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "successorId": "a22fd799-c4dc-4869-a466-0dd6e96f71ce",
      "type": "FS",
      "lagMin": 0
    }
  ]
}

Create (or update) a dependency

POST/api/projects/{projectId}/dependencies

Sleutel met schrijfrecht

A dependency that would close a cycle is refused with 409 dependency_cycle.

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.

Request-body

DependencyCreate

VeldTypeBeschrijving
predecessorId
verplicht
string (uuid)
successorId
verplicht
string (uuid)
typestring

Een van: FS, SS, FF, SF

Standaard: FS

lagMininteger

Standaard: 0

of dependencies

VeldTypeBeschrijving
dependencies
verplicht
array of DependencyCreate

Geeft terug

201 Created Created

VeldTypeBeschrijving
tasksarray of TaskCreated/updated tasks plus the ones the recalculation moved.
deletedTaskIdsarray of string
dependenciesarray of Dependency
deletedDependencyIdsarray of string
conflictsarray of Conflict
projectStartAtstring (date-time)
projectFinishAtstring (date-time)
statsobject
Velden van stats tonen
VeldTypeBeschrijving
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Verzoek
curl -X POST https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/dependencies \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "predecessorId": "4dbd104a-00cd-4035-8955-255f52ea586a",
  "successorId": "a22fd799-c4dc-4869-a466-0dd6e96f71ce",
  "type": "FS",
  "lagMin": 0
}'
Antwoord201 Created
{
  "tasks": [
    {
      "id": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "number": 1,
      "key": "WHX-1",
      "parentId": null,
      "sortKey": "i",
      "name": "Foundations",
      "type": "task",
      "durationMin": 1440,
      "workMin": 0,
      "progressPct": 0,
      "constraintKind": "asap",
      "constraintDate": null,
      "deadline": null,
      "calendarId": null,
      "costFixed": 0,
      "notes": null,
      "color": null,
      "wbs": null,
      "externalId": "crm-4711",
      "startAt": "2026-10-05T06:00:00.000Z",
      "finishAt": "2026-10-07T15:00:00.000Z",
      "isCritical": true,
      "totalFloatMin": 0,
      "earlyStartAt": "2026-10-05T06:00:00.000Z",
      "lateFinishAt": "2026-10-07T15:00:00.000Z",
      "actualStartAt": null,
      "actualFinishAt": null,
      "actualDurationMin": null,
      "remainingDurationMin": null,
      "manuallyScheduled": false,
      "levelingDelayMin": 0,
      "taskType": "fixed_units",
      "effortDriven": false,
      "durationOptimisticMin": null,
      "durationPessimisticMin": null
    }
  ],
  "deletedTaskIds": [],
  "dependencies": [
    {
      "id": "9ba5faf8-923d-4ecc-86f0-f245c5d179db",
      "predecessorId": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "successorId": "a22fd799-c4dc-4869-a466-0dd6e96f71ce",
      "type": "FS",
      "lagMin": 0
    }
  ],
  "deletedDependencyIds": [],
  "conflicts": [],
  "projectStartAt": "2026-10-05T06:00:00.000Z",
  "projectFinishAt": "2026-10-07T15:00:00.000Z",
  "stats": {
    "taskCount": 12,
    "recomputedCount": 3,
    "savedCount": 2,
    "durationMs": 39
  }
}

Remove a dependency

DEL/api/projects/{projectId}/dependencies/{dependencyId}

Sleutel met schrijfrecht

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.
dependencyId
verplicht
string (uuid)

Geeft terug

200 OK Removed

VeldTypeBeschrijving
tasksarray of TaskCreated/updated tasks plus the ones the recalculation moved.
deletedTaskIdsarray of string
dependenciesarray of Dependency
deletedDependencyIdsarray of string
conflictsarray of Conflict
projectStartAtstring (date-time)
projectFinishAtstring (date-time)
statsobject
Velden van stats tonen
VeldTypeBeschrijving
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Verzoek
curl -X DELETE https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/dependencies/9ba5faf8-923d-4ecc-86f0-f245c5d179db \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "tasks": [
    {
      "id": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "number": 1,
      "key": "WHX-1",
      "parentId": null,
      "sortKey": "i",
      "name": "Foundations",
      "type": "task",
      "durationMin": 1440,
      "workMin": 0,
      "progressPct": 0,
      "constraintKind": "asap",
      "constraintDate": null,
      "deadline": null,
      "calendarId": null,
      "costFixed": 0,
      "notes": null,
      "color": null,
      "wbs": null,
      "externalId": "crm-4711",
      "startAt": "2026-10-05T06:00:00.000Z",
      "finishAt": "2026-10-07T15:00:00.000Z",
      "isCritical": true,
      "totalFloatMin": 0,
      "earlyStartAt": "2026-10-05T06:00:00.000Z",
      "lateFinishAt": "2026-10-07T15:00:00.000Z",
      "actualStartAt": null,
      "actualFinishAt": null,
      "actualDurationMin": null,
      "remainingDurationMin": null,
      "manuallyScheduled": false,
      "levelingDelayMin": 0,
      "taskType": "fixed_units",
      "effortDriven": false,
      "durationOptimisticMin": null,
      "durationPessimisticMin": null
    }
  ],
  "deletedTaskIds": [],
  "dependencies": [
    {
      "id": "9ba5faf8-923d-4ecc-86f0-f245c5d179db",
      "predecessorId": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "successorId": "a22fd799-c4dc-4869-a466-0dd6e96f71ce",
      "type": "FS",
      "lagMin": 0
    }
  ],
  "deletedDependencyIds": [],
  "conflicts": [],
  "projectStartAt": "2026-10-05T06:00:00.000Z",
  "projectFinishAt": "2026-10-07T15:00:00.000Z",
  "stats": {
    "taskCount": 12,
    "recomputedCount": 3,
    "savedCount": 2,
    "durationMs": 39
  }
}

API-referentie

People

Project members and task assignees.

Member

Attributen

VeldTypeBeschrijving
userIdstring (uuid)
namestring
emailstring
rolestringEffective role on the project.

Een van: owner, editor, viewer

directRolestringkan null zijnRole granted on the project itself (null = only through the workspace).

Een van: owner, editor, viewer

inheritedbooleanAccess comes from the workspace.
resourceIdstring (uuid)kan null zijnResource used when the person is assigned to tasks.
addedAtstring (date-time)
avatarUrlstringkan null zijn
ObjectenMember
{
  "userId": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
  "name": "Anna Rossi",
  "email": "anna@example.com",
  "role": "owner",
  "directRole": null,
  "inherited": false,
  "resourceId": "0c6a8f52-3d7e-4b19-9a4e-6f1d2c8b7e30",
  "addedAt": "2026-10-01T08:30:12.418Z",
  "avatarUrl": null
}

Assignee

Attributen

VeldTypeBeschrijving
resourceIdstring (uuid)
userIdstring (uuid)kan null zijn
namestring
unitsPctinteger
ObjectenAssignee
{
  "resourceId": "0c6a8f52-3d7e-4b19-9a4e-6f1d2c8b7e30",
  "userId": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
  "name": "Anna Rossi",
  "unitsPct": 100
}

Replace the people assigned to a task

PUT/api/projects/{projectId}/tasks/{taskId}/assignees

Sleutel met schrijfrecht

userIds must be members of the project (GET /members). An empty list removes everyone. Optional resourceIds replaces the people imported from a file (resources without an account) assigned to the task; omit it to leave them as they are.

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.
taskId
verplicht
string (uuid)Task id.

Request-body

VeldTypeBeschrijving
userIds
verplicht
array of string
resourceIdsarray of string

Geeft terug

200 OK Assignees saved

VeldTypeBeschrijving
taskIdstring (uuid)
assignmentsarray of object
Velden van assignments tonen
VeldTypeBeschrijving
idstring (uuid)
taskIdstring (uuid)
resourceIdstring (uuid)
unitsPctinteger
workMininteger
resourcesarray of object
Velden van resources tonen
VeldTypeBeschrijving
idstring (uuid)
userIdstring (uuid)kan null zijn
namestring
kindstring

Een van: work, material, cost

emailstringkan null zijn
costPerHournumber
costPerUsenumber
capacityPctinteger
calendarIdstring (uuid)kan null zijn
colorstringkan null zijn
avatarUrlstringkan null zijn
needsRescheduleboolean
conflictsarray of Conflict
Verzoek
curl -X PUT https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks/4dbd104a-00cd-4035-8955-255f52ea586a/assignees \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"userIds":["b1666432-132a-4ea9-b1ae-76ea69e226c5"]}'
Antwoord200 OK
{
  "taskId": "4dbd104a-00cd-4035-8955-255f52ea586a",
  "assignments": [
    {
      "id": "e62ac96b-e68e-40d3-842e-335e27dfd099",
      "taskId": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "resourceId": "0c6a8f52-3d7e-4b19-9a4e-6f1d2c8b7e30",
      "unitsPct": 100,
      "workMin": 0
    }
  ],
  "resources": [
    {
      "id": "0c6a8f52-3d7e-4b19-9a4e-6f1d2c8b7e30",
      "userId": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "name": "Anna Rossi",
      "kind": "builtin",
      "email": "anna@example.com",
      "costPerHour": 0,
      "costPerUse": 0,
      "capacityPct": 0,
      "calendarId": null,
      "color": null,
      "avatarUrl": null
    }
  ],
  "needsReschedule": false,
  "conflicts": []
}

People with access to the project (assignable)

GET/api/projects/{projectId}/members

Sleutel met leesrecht

Padparameters

VeldTypeBeschrijving
projectId
verplicht
string (uuid)Project id.

Geeft terug

200 OK Members

VeldTypeBeschrijving
membersarray of Member
rolestring
Verzoek
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/members \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "members": [
    {
      "userId": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "name": "Anna Rossi",
      "email": "anna@example.com",
      "role": "owner",
      "directRole": null,
      "inherited": false,
      "resourceId": "0c6a8f52-3d7e-4b19-9a4e-6f1d2c8b7e30",
      "addedAt": "2026-10-01T08:30:12.418Z",
      "avatarUrl": null
    }
  ],
  "role": "owner"
}

API-referentie

Webhooks

Outgoing webhook subscriptions (REST hooks: subscribe/unsubscribe).

Webhook

Attributen

VeldTypeBeschrijving
idstring (uuid)
workspaceIdstring (uuid)
workspaceNamestring
projectIdstring (uuid)kan null zijnnull = every project of the workspace.
projectNamestringkan null zijn
namestring
urlstring (uri)
eventsarray of string

Een van: project.created, project.updated, project.deleted, task.created, task.updated, task.deleted, task.completed, task.dates_changed, dependency.created, dependency.deleted, baseline.saved, member.invited, member.joined, comment.created

secretPrefixstringFirst characters of the signing secret (not secret).
activeboolean
disabledReasonstringkan null zijn

Een van: failures, gone, project_deleted, user

disabledAtstring (date-time)kan null zijn
consecutiveFailuresinteger
viaApibooleanCreated with the API (REST hook) rather than from the profile.
createdByobjectkan null zijn
Velden van createdBy tonen
VeldTypeBeschrijving
idstring (uuid)
namestringkan null zijn
createdAtstring (date-time)
updatedAtstring (date-time)
lastDeliveryAtstring (date-time)kan null zijn
lastSuccessAtstring (date-time)kan null zijn
ObjectenWebhook
{
  "id": "1747ee7f-a395-4d3c-94b0-54b513d71d88",
  "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
  "workspaceName": "Acme Construction",
  "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
  "projectName": "Warehouse expansion",
  "name": "Warehouse sync",
  "url": "https://example.com/hooks/planitude",
  "events": [
    "task.created",
    "task.completed"
  ],
  "secretPrefix": "whsec_Fdwl",
  "active": true,
  "disabledReason": null,
  "disabledAt": null,
  "consecutiveFailures": 0,
  "viaApi": true,
  "createdBy": {
    "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "name": "Anna Rossi"
  },
  "createdAt": "2026-10-01T08:30:12.418Z",
  "updatedAt": "2026-10-01T08:30:12.418Z",
  "lastDeliveryAt": "2026-10-01T08:30:12.418Z",
  "lastSuccessAt": "2026-10-01T08:30:12.418Z"
}

Delivery

Attributen

VeldTypeBeschrijving
idstring (uuid)
eventIdstring (uuid)
eventTypestring
statusstring

Een van: pending, success, failed, cancelled

attemptsinteger
nextAttemptAtstring (date-time)kan null zijn
lastAttemptAtstring (date-time)kan null zijn
responseStatusintegerkan null zijn
responseExcerptstringkan null zijn
errorstringkan null zijn
durationMsintegerkan null zijn
manualboolean
createdAtstring (date-time)
ObjectenDelivery
{
  "id": "4b207161-80f9-40bb-bc3f-d8f70315be00",
  "eventId": "6f1c1d1e-2f4b-4d0a-9a77-2a3c5b1e9f10",
  "eventType": "task.completed",
  "status": "success",
  "attempts": 1,
  "nextAttemptAt": null,
  "lastAttemptAt": "2026-10-01T08:30:12.418Z",
  "responseStatus": 200,
  "responseExcerpt": "{\"ok\":true}",
  "error": null,
  "durationMs": 39,
  "manual": false,
  "createdAt": "2026-10-01T08:30:12.418Z"
}

Event

Attributen

VeldTypeBeschrijving
id
verplicht
string (uuid)Event id, also in the Planitude-Event-Id header: use it to deduplicate.
type
verplicht
string

Een van: project.created, project.updated, project.deleted, task.created, task.updated, task.deleted, task.completed, task.dates_changed, dependency.created, dependency.deleted, baseline.saved, member.invited, member.joined, comment.created, webhook.ping

apiVersion
verplicht
string

Een van: 2026-10-01

createdAt
verplicht
string (date-time)
workspaceId
verplicht
string (uuid)
projectIdstring (uuid)kan null zijn
actorobjectkan null zijnWho made the change (null for system changes).
Velden van actor tonen
VeldTypeBeschrijving
idstring (uuid)
namestringkan null zijn
data
verplicht
object
ObjectenEvent
{
  "id": "6f1c1d1e-2f4b-4d0a-9a77-2a3c5b1e9f10",
  "type": "project.created",
  "apiVersion": "2026-10-01",
  "createdAt": "2026-10-01T08:30:12.418Z",
  "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
  "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
  "actor": {
    "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "name": "Anna Rossi"
  },
  "data": {}
}

Project (event payload)

Compact project representation used in webhook payloads.

Attributen

VeldTypeBeschrijving
idstring (uuid)
workspaceIdstring (uuid)
keystring
namestring
descriptionstringkan null zijn
startDatestring (date)
deadlinestring (date)kan null zijn
currencystring
scheduleFromstring

Een van: forward, backward

colorstringkan null zijn
archivedboolean
createdAtstring (date-time)
updatedAtstring (date-time)
urlstring (uri)
ObjectenProject (event payload)
{
  "id": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
  "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
  "key": "WHX",
  "name": "Warehouse expansion",
  "description": null,
  "startDate": "2026-10-05",
  "deadline": null,
  "currency": "EUR",
  "scheduleFrom": "forward",
  "color": null,
  "archived": false,
  "createdAt": "2026-10-01T08:30:12.418Z",
  "updatedAt": "2026-10-01T08:30:12.418Z",
  "url": "https://planitude.app/app/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8"
}

List webhook subscriptions

GET/api/webhooks

Sleutel met leesrecht

Queryparameters

VeldTypeBeschrijving
workspaceIdstring (uuid)
projectIdstring (uuid)

Geeft terug

200 OK Subscriptions

VeldTypeBeschrijving
webhooksarray of Webhook
Verzoek
curl https://planitude.app/api/webhooks \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "webhooks": [
    {
      "id": "1747ee7f-a395-4d3c-94b0-54b513d71d88",
      "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
      "workspaceName": "Acme Construction",
      "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
      "projectName": "Warehouse expansion",
      "name": "Warehouse sync",
      "url": "https://example.com/hooks/planitude",
      "events": [
        "task.created",
        "task.completed"
      ],
      "secretPrefix": "whsec_Fdwl",
      "active": true,
      "disabledReason": null,
      "disabledAt": null,
      "consecutiveFailures": 0,
      "viaApi": true,
      "createdBy": {
        "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
        "name": "Anna Rossi"
      },
      "createdAt": "2026-10-01T08:30:12.418Z",
      "updatedAt": "2026-10-01T08:30:12.418Z",
      "lastDeliveryAt": "2026-10-01T08:30:12.418Z",
      "lastSuccessAt": "2026-10-01T08:30:12.418Z"
    }
  ]
}

Subscribe (REST hook)

POST/api/webhooks

Sleutel met schrijfrecht

Creates a subscription. The response contains the signing secret: it is shown only once. Aliases accepted for automation platforms: targetUrl for url, event for a single event.

Request-body

VeldTypeBeschrijving
url
verplicht
string (uri)HTTPS endpoint that receives the events. Public addresses only.
events
verplicht
array of string* = all events.

Een van: project.created, project.updated, project.deleted, task.created, task.updated, task.deleted, task.completed, task.dates_changed, dependency.created, dependency.deleted, baseline.saved, member.invited, member.joined, comment.created, *

namestring
projectIdstring (uuid)Limit to one project (editor role needed). Omit for the whole workspace (owner/admin).
workspaceIdstring (uuid)

Geeft terug

201 Created Created

VeldTypeBeschrijving
webhookWebhook
secretstringwhsec_...
Verzoek
curl -X POST https://planitude.app/api/webhooks \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com/hooks/planitude",
  "events": [
    "task.created",
    "task.completed"
  ],
  "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8"
}'
Antwoord201 Created
{
  "webhook": {
    "id": "1747ee7f-a395-4d3c-94b0-54b513d71d88",
    "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
    "workspaceName": "Acme Construction",
    "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
    "projectName": "Warehouse expansion",
    "name": "Warehouse sync",
    "url": "https://example.com/hooks/planitude",
    "events": [
      "task.created",
      "task.completed"
    ],
    "secretPrefix": "whsec_Fdwl",
    "active": true,
    "disabledReason": null,
    "disabledAt": null,
    "consecutiveFailures": 0,
    "viaApi": true,
    "createdBy": {
      "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "name": "Anna Rossi"
    },
    "createdAt": "2026-10-01T08:30:12.418Z",
    "updatedAt": "2026-10-01T08:30:12.418Z",
    "lastDeliveryAt": "2026-10-01T08:30:12.418Z",
    "lastSuccessAt": "2026-10-01T08:30:12.418Z"
  },
  "secret": "whsec_3dvU0T1oaYlW4kH6m2Vb8nqXcR9eZpLsYw1QhGk"
}

Event catalog (public)

GET/api/webhooks/events

Openbaar, zonder sleutel

Geeft terug

200 OK Events

VeldTypeBeschrijving
apiVersionstring
eventsarray of string
Verzoek
curl https://planitude.app/api/webhooks/events
Antwoord200 OK
{
  "apiVersion": "2026-10-01",
  "events": [
    "project.created",
    "project.updated",
    "project.deleted",
    "task.created",
    "task.updated",
    "task.deleted",
    "task.completed",
    "task.dates_changed",
    "dependency.created",
    "dependency.deleted",
    "baseline.saved",
    "member.invited",
    "member.joined",
    "comment.created"
  ]
}

Get a subscription

GET/api/webhooks/{webhookId}

Sleutel met leesrecht

Padparameters

VeldTypeBeschrijving
webhookId
verplicht
string (uuid)Webhook id.

Geeft terug

200 OK Subscription

VeldTypeBeschrijving
webhookWebhook
Verzoek
curl https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88 \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "webhook": {
    "id": "1747ee7f-a395-4d3c-94b0-54b513d71d88",
    "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
    "workspaceName": "Acme Construction",
    "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
    "projectName": "Warehouse expansion",
    "name": "Warehouse sync",
    "url": "https://example.com/hooks/planitude",
    "events": [
      "task.created",
      "task.completed"
    ],
    "secretPrefix": "whsec_Fdwl",
    "active": true,
    "disabledReason": null,
    "disabledAt": null,
    "consecutiveFailures": 0,
    "viaApi": true,
    "createdBy": {
      "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "name": "Anna Rossi"
    },
    "createdAt": "2026-10-01T08:30:12.418Z",
    "updatedAt": "2026-10-01T08:30:12.418Z",
    "lastDeliveryAt": "2026-10-01T08:30:12.418Z",
    "lastSuccessAt": "2026-10-01T08:30:12.418Z"
  }
}

Update, pause or resume a subscription

PATCH/api/webhooks/{webhookId}

Sleutel met schrijfrecht

Padparameters

VeldTypeBeschrijving
webhookId
verplicht
string (uuid)Webhook id.

Request-body

VeldTypeBeschrijving
namestring
urlstring (uri)
eventsarray of string
activebooleanfalse = pause; true = resume (also resets the failure counter).

Geeft terug

200 OK Updated

VeldTypeBeschrijving
webhookWebhook
Verzoek
curl -X PATCH https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88 \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"active":false}'
Antwoord200 OK
{
  "webhook": {
    "id": "1747ee7f-a395-4d3c-94b0-54b513d71d88",
    "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
    "workspaceName": "Acme Construction",
    "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
    "projectName": "Warehouse expansion",
    "name": "Warehouse sync",
    "url": "https://example.com/hooks/planitude",
    "events": [
      "task.created",
      "task.completed"
    ],
    "secretPrefix": "whsec_Fdwl",
    "active": true,
    "disabledReason": null,
    "disabledAt": null,
    "consecutiveFailures": 0,
    "viaApi": true,
    "createdBy": {
      "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "name": "Anna Rossi"
    },
    "createdAt": "2026-10-01T08:30:12.418Z",
    "updatedAt": "2026-10-01T08:30:12.418Z",
    "lastDeliveryAt": "2026-10-01T08:30:12.418Z",
    "lastSuccessAt": "2026-10-01T08:30:12.418Z"
  }
}

Unsubscribe (REST hook)

DEL/api/webhooks/{webhookId}

Sleutel met schrijfrecht

Padparameters

VeldTypeBeschrijving
webhookId
verplicht
string (uuid)Webhook id.

Geeft terug

204 No Content Deleted

Verzoek
curl -X DELETE https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88 \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"

Delivery log (newest first, kept 30 days)

GET/api/webhooks/{webhookId}/deliveries

Sleutel met leesrecht

Padparameters

VeldTypeBeschrijving
webhookId
verplicht
string (uuid)Webhook id.

Queryparameters

VeldTypeBeschrijving
limitinteger1-100.

Standaard: 50

beforestring (date-time)nextCursor of the previous page.

Geeft terug

200 OK Deliveries

VeldTypeBeschrijving
deliveriesarray of Delivery
nextCursorstringkan null zijn
Verzoek
curl https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/deliveries \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "deliveries": [
    {
      "id": "4b207161-80f9-40bb-bc3f-d8f70315be00",
      "eventId": "6f1c1d1e-2f4b-4d0a-9a77-2a3c5b1e9f10",
      "eventType": "task.completed",
      "status": "success",
      "attempts": 1,
      "nextAttemptAt": null,
      "lastAttemptAt": "2026-10-01T08:30:12.418Z",
      "responseStatus": 200,
      "responseExcerpt": "{\"ok\":true}",
      "error": null,
      "durationMs": 39,
      "manual": false,
      "createdAt": "2026-10-01T08:30:12.418Z"
    }
  ],
  "nextCursor": null
}

Body sent with a delivery

GET/api/webhooks/{webhookId}/deliveries/{deliveryId}

Sleutel met leesrecht

Padparameters

VeldTypeBeschrijving
webhookId
verplicht
string (uuid)Webhook id.
deliveryId
verplicht
string (uuid)

Geeft terug

200 OK Payload

VeldTypeBeschrijving
payloadEvent
Verzoek
curl https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/deliveries/4b207161-80f9-40bb-bc3f-d8f70315be00 \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "payload": {
    "id": "6f1c1d1e-2f4b-4d0a-9a77-2a3c5b1e9f10",
    "type": "project.created",
    "apiVersion": "2026-10-01",
    "createdAt": "2026-10-01T08:30:12.418Z",
    "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
    "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
    "actor": {
      "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "name": "Anna Rossi"
    },
    "data": {}
  }
}

Send the same event again

POST/api/webhooks/{webhookId}/deliveries/{deliveryId}/redeliver

Sleutel met schrijfrecht

Padparameters

VeldTypeBeschrijving
webhookId
verplicht
string (uuid)Webhook id.
deliveryId
verplicht
string (uuid)

Geeft terug

202 Accepted Queued

VeldTypeBeschrijving
deliveryDelivery
Verzoek
curl -X POST https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/deliveries/4b207161-80f9-40bb-bc3f-d8f70315be00/redeliver \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord202 Accepted
{
  "delivery": {
    "id": "4b207161-80f9-40bb-bc3f-d8f70315be00",
    "eventId": "6f1c1d1e-2f4b-4d0a-9a77-2a3c5b1e9f10",
    "eventType": "task.completed",
    "status": "success",
    "attempts": 1,
    "nextAttemptAt": null,
    "lastAttemptAt": "2026-10-01T08:30:12.418Z",
    "responseStatus": 200,
    "responseExcerpt": "{\"ok\":true}",
    "error": null,
    "durationMs": 39,
    "manual": false,
    "createdAt": "2026-10-01T08:30:12.418Z"
  }
}

Send a webhook.ping test event

POST/api/webhooks/{webhookId}/test

Sleutel met schrijfrecht

Padparameters

VeldTypeBeschrijving
webhookId
verplicht
string (uuid)Webhook id.

Geeft terug

202 Accepted Queued

VeldTypeBeschrijving
deliveryDelivery
Verzoek
curl -X POST https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/test \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord202 Accepted
{
  "delivery": {
    "id": "4b207161-80f9-40bb-bc3f-d8f70315be00",
    "eventId": "6f1c1d1e-2f4b-4d0a-9a77-2a3c5b1e9f10",
    "eventType": "task.completed",
    "status": "success",
    "attempts": 1,
    "nextAttemptAt": null,
    "lastAttemptAt": "2026-10-01T08:30:12.418Z",
    "responseStatus": 200,
    "responseExcerpt": "{\"ok\":true}",
    "error": null,
    "durationMs": 39,
    "manual": false,
    "createdAt": "2026-10-01T08:30:12.418Z"
  }
}

Generate a new signing secret

POST/api/webhooks/{webhookId}/rotate-secret

Sleutel met schrijfrecht

Padparameters

VeldTypeBeschrijving
webhookId
verplicht
string (uuid)Webhook id.

Geeft terug

200 OK New secret (shown once)

VeldTypeBeschrijving
webhookWebhook
secretstring
Verzoek
curl -X POST https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/rotate-secret \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord200 OK
{
  "webhook": {
    "id": "1747ee7f-a395-4d3c-94b0-54b513d71d88",
    "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
    "workspaceName": "Acme Construction",
    "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
    "projectName": "Warehouse expansion",
    "name": "Warehouse sync",
    "url": "https://example.com/hooks/planitude",
    "events": [
      "task.created",
      "task.completed"
    ],
    "secretPrefix": "whsec_Fdwl",
    "active": true,
    "disabledReason": null,
    "disabledAt": null,
    "consecutiveFailures": 0,
    "viaApi": true,
    "createdBy": {
      "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "name": "Anna Rossi"
    },
    "createdAt": "2026-10-01T08:30:12.418Z",
    "updatedAt": "2026-10-01T08:30:12.418Z",
    "lastDeliveryAt": "2026-10-01T08:30:12.418Z",
    "lastSuccessAt": "2026-10-01T08:30:12.418Z"
  },
  "secret": "whsec_3dvU0T1oaYlW4kH6m2Vb8nqXcR9eZpLsYw1QhGk"
}

Webhooks

Webhooks

Webhooks sturen een HTTPS-POST met een JSON-body naar je endpoint zodra er iets verandert, of de wijziging nu uit de web-app, de API, de MCP-server of een import komt. Een webhook dekt één project, of alle projecten van een workspace (eigenaren en beheerders).

Maak ze aan in Profiel → Webhooks of via de API, als REST hooks: abonneren met POST /api/webhooks, opzeggen met DELETE. Het ondertekeningsgeheim wordt maar één keer getoond.

Elk verzoek bevat deze headers:

HeaderBeschrijving
Planitude-Signaturet=<unix seconds>,v1=<hex HMAC-SHA256>: see Verify signatures.
Planitude-EventEvent type, e.g. task.completed.
Planitude-Event-IdEvent id, the same in every retry: use it to deduplicate.
Planitude-DeliveryId of this delivery (changes with a manual resend).
User-AgentPlanitude-Webhooks/1.0 (+https://planitude.app/developers)
Content-Typeapplication/json
Verzoek
curl -X POST https://planitude.app/api/webhooks \
  -H "Authorization: Bearer $PLANITUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com/hooks/planitude",
  "events": [
    "task.created",
    "task.completed"
  ],
  "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8"
}'
Antwoord201 Created
{
  "webhook": {
    "id": "1747ee7f-a395-4d3c-94b0-54b513d71d88",
    "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
    "workspaceName": "Acme Construction",
    "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
    "projectName": "Warehouse expansion",
    "name": "Warehouse sync",
    "url": "https://example.com/hooks/planitude",
    "events": [
      "task.created",
      "task.completed"
    ],
    "secretPrefix": "whsec_Fdwl",
    "active": true,
    "disabledReason": null,
    "disabledAt": null,
    "consecutiveFailures": 0,
    "viaApi": true,
    "createdBy": {
      "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
      "name": "Anna Rossi"
    },
    "createdAt": "2026-10-01T08:30:12.418Z",
    "updatedAt": "2026-10-01T08:30:12.418Z",
    "lastDeliveryAt": "2026-10-01T08:30:12.418Z",
    "lastSuccessAt": "2026-10-01T08:30:12.418Z"
  },
  "secret": "whsec_3dvU0T1oaYlW4kH6m2Vb8nqXcR9eZpLsYw1QhGk"
}

Eventtypen

Abonneer je op losse events, of op * voor alle events. Elk event heeft dezelfde envelop; data verschilt per type.

EventBeschrijving
project.createdA project was created (blank, from a template, duplicated or imported from MS Project).
project.updatedProject fields changed (name, dates, deadline, archive...), or a saved version was restored.
project.deletedA project was deleted.
task.createdA task was created.
task.updatedTask fields or assignees changed. changes lists only the fields that changed.
task.deletedA task was deleted (one event per task of a deleted branch).
task.completedTask progress reached 100%.
task.dates_changedStart or finish moved, because of an edit (cause: edit) or because the schedule was recalculated (cause: reschedule).
dependency.createdA dependency was created or changed.
dependency.deletedA dependency was removed.
baseline.savedA baseline was saved.
member.invitedAn invite link was created for the project.
member.joinedA person joined the project.
comment.createdA comment was added to a task.
Voorbeeldpayload
{
  "id": "6f1c1d1e-2f4b-4d0a-9a77-2a3c5b1e9f10",
  "type": "project.created",
  "apiVersion": "2026-10-01",
  "createdAt": "2026-10-01T08:30:12.418Z",
  "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
  "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
  "actor": {
    "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
    "name": "Anna Rossi"
  },
  "data": {
    "project": {
      "id": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
      "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
      "key": "WHX",
      "name": "Warehouse expansion",
      "description": null,
      "startDate": "2026-10-05",
      "deadline": null,
      "currency": "EUR",
      "scheduleFrom": "forward",
      "color": null,
      "archived": false,
      "createdAt": "2026-10-01T08:30:12.418Z",
      "updatedAt": "2026-10-01T08:30:12.418Z",
      "url": "https://planitude.app/app/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8"
    },
    "source": "blank"
  }
}

Handtekeningen controleren

Elk verzoek is ondertekend met HMAC-SHA256 en het geheim van je webhook. De header Planitude-Signature bevat een tijdstempel t en de handtekening v1, berekend over t, een punt en de ruwe body.

  1. Gebruik de ruwe body, vóór elke JSON-parsing: een opnieuw geserialiseerde body heeft een andere handtekening.
  2. Bereken de HMAC en vergelijk in constante tijd.
  3. Weiger verzoeken waarvan de tijdstempel meer dan 5 minuten van je klok afwijkt: een onderschept verzoek kan niet opnieuw worden afgespeeld.
  4. Vervang het geheim wanneer je wilt: het oude werkt direct niet meer.
Verify
import { createHmac, timingSafeEqual } from "node:crypto";

// rawBody: the request body as a string, before JSON.parse
export function verifyPlanitude(rawBody, header, secret, toleranceSec = 300) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const t = Number(parts.t);
  if (!t || Math.abs(Date.now() / 1000 - t) > toleranceSec) return false; // replay
  const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest();
  const given = Buffer.from(parts.v1 ?? "", "hex");
  return given.length === expected.length && timingSafeEqual(given, expected);
}

// Express: app.post("/hooks/planitude", express.raw({ type: "application/json" }), (req, res) => {
//   if (!verifyPlanitude(req.body.toString("utf8"), req.get("Planitude-Signature"), process.env.PLANITUDE_WEBHOOK_SECRET)) return res.sendStatus(400);
//   res.sendStatus(200); // then process the event in a queue
// });

Herhalingen en aflevering

Antwoord binnen 10 seconden met een willekeurige 2xx en doe het echte werk daarna, in een wachtrij. Redirects worden niet gevolgd. Bij fouten en time-outs probeert Planitude het in totaal tot 6 keer: meteen, daarna na 1 min, 5 min, 30 min, 2 h, 12 h.

Aflevering is minstens één keer en niet op volgorde. Bewaar het event-id (Planitude-Event-Id, ook id in de body) en sla events over die je al hebt verwerkt; sorteer op createdAt.

Als 5 events op rij bij elke poging mislukken, wordt de webhook uitgeschakeld en krijgt de eigenaar een e-mail. Een antwoord 410 Gone schakelt hem direct uit. Zet hem weer aan in je profiel, of met PATCH en active: true.

Het afleverlogboek (status, HTTP-code, fragment van het antwoord, payload, handmatig opnieuw versturen) wordt 30 dagen bewaard. Alleen openbare adressen zijn toegestaan als bestemming.

Herhaalschema6 × POST
Poging 1   meteen
Poging 2   + 1 min
Poging 3   + 5 min
Poging 4   + 30 min
Poging 5   + 2 h
Poging 6   + 12 h

Je endpoint testen

  1. Stuur een event webhook.ping met het testendpoint, of met de knop Testen in je profiel.
  2. Om events op je computer te ontvangen, maak je je lokale server bereikbaar met een tunnel (bijvoorbeeld ngrok of Cloudflare Tunnel) en abonneer je het openbare HTTPS-adres.
  3. Open het afleverlogboek voor status, HTTP-code en antwoord, en verstuur een aflevering opnieuw zodra je endpoint is verbeterd.
Verzoek
curl -X POST https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/test \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwoord202 Accepted
{
  "delivery": {
    "id": "4b207161-80f9-40bb-bc3f-d8f70315be00",
    "eventId": "6f1c1d1e-2f4b-4d0a-9a77-2a3c5b1e9f10",
    "eventType": "task.completed",
    "status": "success",
    "attempts": 1,
    "nextAttemptAt": null,
    "lastAttemptAt": "2026-10-01T08:30:12.418Z",
    "responseStatus": 200,
    "responseExcerpt": "{\"ok\":true}",
    "error": null,
    "durationMs": 39,
    "manual": false,
    "createdAt": "2026-10-01T08:30:12.418Z"
  }
}

AI en MCP

MCP-server

Planitude is een MCP-server (Model Context Protocol): AI-assistenten en code-editors lezen projecten, analyseren kritiek pad en werklast, en maken of wijzigen taken, met jouw rechten. Web-apps koppelen met OAuth (je logt in en geeft toegang); commandoregeltools en editors gebruiken een API-sleutel.

Server-URL

https://planitude.app/mcp

  • ChatGPTOAuth

    Open in ChatGPT Instellingen › Beveiliging en inloggen en zet de ontwikkelaarsmodus aan. Maak een app met de server-URL en OAuth-authenticatie, log daarna in bij Planitude en geef toegang.

    Officiële documentatie ↗
  • ClaudeOAuth

    Open Aanpassen › Connectoren › Aangepaste connector toevoegen, plak de server-URL en kies Verbinden: Planitude opent, je logt in en geeft toegang. Werkt in claude.ai, Claude Desktop en de mobiele app.

    Officiële documentatie ↗
  • GeminiOAuth

    Open op gemini.google.com Instellingen › Gekoppelde apps, kies Aangepaste app toevoegen en plak de server-URL; log daarna in bij Planitude en geef toegang.

    Officiële documentatie ↗
  • Claude CodeAPI-sleutel

    Voer het commando uit met de sleutel in een omgevingsvariabele. Voeg --scope user toe om het in alle projecten te gebruiken en controleer met claude mcp list.

    Officiële documentatie ↗
  • CodexAPI-sleutel

    Zet de sleutel in PLANITUDE_API_KEY en voeg het blok toe aan ~/.codex/config.toml: het geldt voor de CLI, de app en de IDE-extensie.

    Officiële documentatie ↗
  • CursorAPI-sleutel

    Voeg het blok toe aan ~/.cursor/mcp.json (alle projecten) of .cursor/mcp.json (één project); Cursor leest de sleutel uit de omgeving.

    Officiële documentatie ↗
  • Voeg .vscode/mcp.json toe aan de workspace: VS Code vraagt één keer om de sleutel en bewaart hem veilig, buiten het bestand.

    Officiële documentatie ↗
  • Gemini CLIAPI-sleutel

    Voer het commando uit met de sleutel in een omgevingsvariabele, of voeg het blok toe aan ~/.gemini/settings.json.

    Officiële documentatie ↗

Tools

De server biedt 29 tools, van lezen en analyseren tot veilige wijzigingen. Geen enkele verwijdert projecten of taken.

read

  • planitude_list_projects
  • planitude_portfolio_overview
  • planitude_get_project
  • planitude_critical_path
  • planitude_delay_impact
  • planitude_monte_carlo
  • planitude_workload
  • planitude_list_baselines
  • planitude_list_versions
  • planitude_list_templates
  • planitude_list_comments
  • planitude_preview_import

write

  • planitude_create_project
  • planitude_create_project_from_template
  • planitude_create_project_from_plan
  • planitude_import_file
  • planitude_edit_project
  • planitude_add_task
  • planitude_update_task
  • planitude_set_progress
  • planitude_indent_task
  • planitude_outdent_task
  • planitude_link_tasks
  • planitude_unlink_tasks
  • planitude_reschedule
  • planitude_configure_simulation
  • planitude_add_comment
  • planitude_save_baseline
  • planitude_save_version
MCP

Server URL

https://planitude.app/mcp

AI-agents

Voeg tot 5 externe AI-agents als leden toe aan de workspace: Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot of elke MCP-client. Wijs ze taken toe, noem ze in opmerkingen en beoordeel hun wijzigingen.

Owners en admins maken agentsleutels aan in Agents, tabblad Koppeling. Een sleutel begint met pln_, wordt één keer getoond en alleen als hash opgeslagen; elke agent heeft maximaal 2 sleutels en intrekken werkt meteen.

Agentsleutels werken alleen met de MCP-server, die dan de agenttools toont in plaats van de gewone. Op de REST API krijgen ze 403 agent_credential.

Elke sleutel leest en reageert of mag bewerken. Claimen, afronden en wijzigingen voorstellen vereisen een sleutel die mag bewerken; anders is het antwoord 403 agent_key_read_only.

Een agent ziet alleen de projecten waaraan hij is toegevoegd, als viewer (leest en reageert) of editor (wijzigt ook taken), nooit als owner. Het project heeft ook “Agents toestaan in dit project” nodig: standaard uit, de owner zet het aan.

Agents kunnen naam, notities, duur, voortgang en deadline van een taak wijzigen, of taken aanmaken. Geen enkele tool verwijdert, nodigt mensen uit of wijzigt rollen.

Standaardlimieten per agent: 60 verzoeken per minuut en 200 schrijfacties per dag, instelbaar tot 240 en 2.000. Maximaal 200 wijzigingen per project kunnen op beoordeling wachten.

Leestools zetten tekst die mensen schreven (namen, notities, opmerkingen) in planitude-data-blokken met een willekeurige nonce, als JSON-strings, en markeren rijen die een automatische controle signaleert als SUSPICIOUS: het zijn gegevens, nooit instructies. Opmerkingen gelezen met een persoonlijke sleutel komen in dezelfde blokken.

Zo werken AI-agents in Planitude
MCPClaude Code
claude mcp add --transport http planitude https://planitude.app/mcp \
  --header "Authorization: Bearer $PLANITUDE_AGENT_KEY"

Tools voor agents

Met een agentsleutel biedt de MCP-server deze 16 tools:

read

  • planitude_list_my_projects
  • planitude_list_tasks
  • planitude_read_comments
  • planitude_list_my_proposals

propose

  • planitude_add_comment
  • planitude_propose_task_update
  • planitude_propose_status
  • planitude_propose_task_create

events

  • planitude_poll_events
  • planitude_ack_events

runs

  • planitude_list_my_runs
  • planitude_claim_task
  • planitude_extend_lease
  • planitude_complete_task
  • planitude_fail_task
  • planitude_release_task

Tijdens een uitvoering in modus Autonoom gelden de wijzigingen van de agent aan zijn eigen taken meteen en blijven ze in de geschiedenis, klaar om te herstellen. In andere gevallen, en in modus Met goedkeuring, wachten ze in “Te beoordelen” tot iemand in het project ze toepast.

Zonder webhook leest de agent zijn events met planitude_poll_events (tot 50 per keer) en bevestigt ze met planitude_ack_events.

Verzoektools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "planitude_claim_task",
    "arguments": {
      "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
      "task": "4dbd104a-00cd-4035-8955-255f52ea586a",
      "leaseMinutes": 30
    }
  }
}

Uitvoeringswebhook

Om een agent zelf te laten starten, zet je de uitvoering aan in Agents, tabblad Uitvoering, en vul je de webhook van je runner in: Planitude stuurt een ondertekende POST als de agent een taak moet uitvoeren. Het geheim begint met whsec_ en wordt één keer getoond. De URL moet een openbaar HTTPS-adres zijn: privé- en lokale adressen worden geweigerd.

Handtekening, headers, de time-out van 10 seconden en herhalingen (1 min, 5 min, 30 min, 2 h, 12 h) werken als bij de andere webhooks. Na 5 mislukte leveringen op rij gaat de webhook uit: sla de URL opnieuw op om hem weer aan te zetten.

De melding bevat alleen id’s, nooit taaktekst: de agent leest de taak via MCP.

EventBeschrijving
task.assignedOnly with the “on assignment” trigger: a person assigned the task to the agent. Once per assignment.
task.start_dueDefault trigger: the task’s start date has come (a working day of its calendar).
task.due_todayThe task is due today (deadline or planned finish). Opens a run only if the task never had one.
task.overdueThe task is past its due date, once per due date. Opens a run only if the task never had one.
run.retryThe lease expired without completion, or a person chose Rerun: a new attempt is queued.
run.cancelA run in progress was cancelled (by a person, an emergency stop or the rules): stop working on it.
webhook.pingSent by “Send test event” in the agent’s Execution tab.

Een melding met newRun: true opent een uitvoering. De agent claimt die met planitude_claim_task en houdt een lease van 30 minuten (5 tot 240), verlengd met planitude_extend_lease. Verloopt de lease, dan start een nieuwe poging, tot 3 (maximaal 10). Een uitvoering die niemand claimt, vervalt na 24 uur.

planitude_complete_task zet de taak op 100% en plaatst het rapport als opmerking; met open subtaken is het antwoord 409 subtasks_open. planitude_fail_task legt de reden vast en waarschuwt het team, dat hem opnieuw kan starten; planitude_release_task geeft de taak terug zonder nieuwe poging.

Elke uitvoering staat 50 wijzigingen toe (tot 500, daarna 429) en elke agent 5 open uitvoeringen (daarna 409 too_many_open_runs). Autonoom, de standaardmodus, past wijzigingen meteen toe en laat je ze herstellen; Met goedkeuring stuurt ze ter beoordeling. Een noodstop, per project of voor de hele workspace, annuleert open uitvoeringen en blokkeert schrijfacties.

Voorbeeldpayloadtask.start_due
{
  "id": "6f1c1d1e-2f4b-4d0a-9a77-2a3c5b1e9f10",
  "type": "task.start_due",
  "apiVersion": "2026-10-01",
  "createdAt": "2026-10-14T07:00:00.000Z",
  "workspaceId": "824650d2-d0b3-4cac-8df8-5743ae9ff65a",
  "projectId": "40be00e0-7e34-4f7a-864b-5cc986f575b8",
  "actor": null,
  "data": {
    "agentId": "b4d17e2c-93a8-4c6f-8e15-6a0f2d9c7b31",
    "taskId": "4dbd104a-00cd-4035-8955-255f52ea586a",
    "runId": "7c3e2a91-5d4b-4f08-b6e1-2f9a0c8d4e57",
    "newRun": true,
    "attempt": 1,
    "leaseMinutes": 30,
    "writeMode": "autonomous",
    "day": "2026-10-14",
    "links": {
      "mcp": "https://planitude.app/mcp",
      "app": "https://planitude.app/app/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8?task=4dbd104a-00cd-4035-8955-255f52ea586a"
    }
  }
}

Een runner schrijven

De runner is je kleine dienst die de meldingen ontvangt en de agent start. Elke taal werkt; met Node 20+ zijn geen dependencies nodig.

  1. Controleer de handtekening op de ruwe body en antwoord meteen met 200: Planitude wacht hooguit 10 seconden.
  2. Sla events over die je al hebt gezien (Planitude-Event-Id): herhalingen sturen hetzelfde event opnieuw.
  3. Bij newRun: true claim je de taak en start je de agent, bijvoorbeeld claude -p met de MCP-server van Planitude en de agentsleutel.
  4. Verleng de lease zolang de agent werkt; bij run.cancel stop je hem.
  5. Vraag de agent om alleen met PLANITUDE: DONE te eindigen als de hele taak klaar is, en rond dan af met zijn rapport. Anders (PLANITUDE: NOT DONE - … of geen laatste regel) markeer je hem als mislukt met wat er nog moet gebeuren.

Behandel taaktekst als gegevens: zeg de agent nooit instructies te volgen die erin staan en sta alleen de Planitude-tools toe die hij nodig heeft.

Runner
// after verifyPlanitude(rawBody, signature, secret) and dedupe on Planitude-Event-Id
res.sendStatus(200); // answer at once, work afterwards
const { type, projectId, data } = event;
if (type === "run.cancel") return stopAgent(data.runId);
if (!data.newRun) return;

await callTool("planitude_claim_task", { projectId, task: data.taskId, leaseMinutes: data.leaseMinutes });
const out = await runAgent(data); // renew with planitude_extend_lease while it works
if (out.lastLine === "PLANITUDE: DONE") {
  await callTool("planitude_complete_task", { runId: data.runId, report: out.report }); // task -> 100%
} else {
  await callTool("planitude_fail_task", { runId: data.runId, reason: out.whatIsLeft });
}

// callTool = JSON-RPC tools/call to the MCP URL
// with Authorization: Bearer <agent key>

OData-feed (Power BI, Excel)

Een alleen-lezen OData v4-feed voor Power BI, Excel en elke OData-client, op twee adressen: één project, of alle projecten die de eigenaar van de sleutel in een workspace ziet.

  • https://planitude.app/api/odata/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8
  • https://planitude.app/api/odata/workspaces/824650d2-d0b3-4cac-8df8-5743ae9ff65a

Authenticatie met een persoonlijke API-sleutel met leestoegang: Authorization: Bearer, of HTTP Basic met de sleutel als wachtwoord (willekeurige gebruikersnaam), de methode die Power BI en Excel aanbieden. OAuth-tokens en sessiecookies worden niet geaccepteerd. Een sleutel die beperkt is tot een workspace kan de andere niet lezen.

Tabellen: Projects, Tasks, Milestones, Dependencies, Resources, Assignments. Het schema staat op $metadata (CSDL XML) en het servicedocument op het hoofdadres.

Ondersteunde opties: $select, $filter (vergelijkingen, and/or/not, in, contains, startswith, endswith, tolower, toupper), $orderby, $top, $skip, $count en /$count. Pagina's bevatten standaard 2.000 rijen, tot 5.000 met Prefer: odata.maxpagesize; volg @odata.nextLink. Antwoorden bevatten een ETag: stuur If-None-Match om 304 te krijgen. $expand, $apply en $search worden niet ondersteund (400).

Een feed omvat maximaal 500 projecten en 25.000 taken (daarboven 413). Verzoeken tellen mee voor de leeslimiet van de sleutel, 240 per minuut.

Stapsgewijze handleiding voor Power BI en Excel
VerzoekcURL
curl "https://planitude.app/api/odata/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/Tasks?$select=Key,Name,Start,Finish,ProgressPct,IsCritical&$filter=IsCritical&$orderby=Start&$top=2&$count=true" \
  -u "powerbi:$PLANITUDE_API_KEY"

# schema (CSDL XML), for Power BI, Excel and any OData client
curl "https://planitude.app/api/odata/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/$metadata" -u "powerbi:$PLANITUDE_API_KEY"
Antwoord200 OK
{
  "@odata.context": "https://planitude.app/api/odata/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/$metadata#Tasks(Key,Name,Start,Finish,ProgressPct,IsCritical)",
  "@odata.count": 3,
  "value": [
    {
      "Key": "WHX-2",
      "Name": "Foundations",
      "Start": "2026-10-05T07:00:00Z",
      "Finish": "2026-10-06T15:00:00Z",
      "ProgressPct": 100,
      "IsCritical": true
    },
    {
      "Key": "WHX-3",
      "Name": "Walls",
      "Start": "2026-10-07T07:00:00Z",
      "Finish": "2026-10-09T15:00:00Z",
      "ProgressPct": 50,
      "IsCritical": true
    }
  ]
}

Wijzigingen

  1. Nieuwe alleen-lezen OData v4-feed op /api/odata/projects/:projectId en /api/odata/workspaces/:workspaceId voor Power BI, Excel en andere OData-clients: zes tabellen, $metadata, $select, $filter, $orderby, $top, $skip, $count, paginering aan serverzijde en ETag.

  2. Nieuw endpoint GET /api/projects/:projectId/export: het plan als Microsoft Project XML, CSV, PNG-afbeelding of pdf, met opties voor schaal, periode, kritiek pad, basislijn, afhankelijkheden, papierformaat en afdrukstand.

  3. Alle API-sleutels beginnen nu met pln_. Sleutels die met gnt_ beginnen, werken niet meer: maak een nieuwe aan.

  4. Agents voeren taken uit: ondertekende uitvoeringswebhook (task.assigned, task.start_due, task.due_today, task.overdue, run.retry, run.cancel), 6 uitvoeringstools met lease en een handleiding voor het schrijven van een runner.

  5. MCP-leestools verpakken tekst die mensen schreven in planitude-data-blokken met een nonce, als JSON-strings met een SUSPICIOUS-markering, voor elk soort sleutel.

  6. AI-agents als workspaceleden: agentsleutels die alleen met de MCP-server werken, 10 tools om te lezen, te reageren en wijzigingen voor te stellen, en een eventwachtrij.

  7. Nieuwe ontwikkelaarsdocumentatie, gegenereerd uit het OpenAPI-document. Het OpenAPI-document beschrijft nu alle velden die terugkomen voor leden, opmerkingen, basislijnen, sjablonen en toewijzingen.

  8. API-versie 2026-10-01: ondertekende uitgaande webhooks, gedocumenteerde openbare REST-API (OpenAPI 3.1), paginering met cursor en zoeken op externalId.

  9. OAuth 2.1 voor de MCP-server en de API: ChatGPT, Claude en Gemini koppelen zonder een sleutel te kopiëren.

  10. MCP-server en persoonlijke API-sleutels met leesrecht of lees- en schrijfrecht.

Advertenties houden Planitude gratis