Entwickler

Mit Planitude entwickeln

Eine REST-API, signierte Webhooks und ein MCP-Server: Halten Sie Ihre Systeme mit dem Plan synchron, reagieren Sie auf jede Änderung und lassen Sie einen KI-Assistenten an Ihren Projekten arbeiten.

Code, Feldnamen und die technische Referenz sind auf Englisch, wie in den meisten API-Dokumentationen.

Basis-URL: https://planitude.app

Anfragen und Antworten sind JSON über HTTPS. Dauern und Abstände sind in Arbeitsminuten (ein 8-Stunden-Tag sind 480), Zeitpunkte ISO 8601 in UTC, Daten ohne Uhrzeit YYYY-MM-DD.

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

Schnellstart

In drei Schritten zum ersten Webhook. Sie brauchen nur ein Terminal.

  1. API-Schlüssel erstellen

    Öffnen Sie Profil → API-Schlüssel, wählen Sie Lesen und schreiben und kopieren Sie den Schlüssel: Er beginnt mit pln_ und wird nur einmal angezeigt. Legen Sie ihn in einer Umgebungsvariablen ab.

  2. Erster Aufruf

    Listen Sie die Projekte auf, die Sie sehen. Der Schlüssel handelt als Sie: dieselben Projekte, dieselben Rollen.

  3. Einen Webhook empfangen

    Abonnieren Sie mit einem öffentlichen HTTPS-Endpunkt die Ereignisse, die Sie brauchen, senden Sie sofort ein Testereignis und prüfen Sie seine Signatur.

1Terminal
export PLANITUDE_API_KEY="pln_…"
2
curl https://planitude.app/api/projects \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Erwartetes Ergebnis200 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"
}'
Beispiel-Payloadwebhook.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"
      ]
    }
  }
}

Authentifizierung

Authentifizieren Sie jede Anfrage mit einem persönlichen API-Schlüssel im Header Authorization, als Bearer-Token. Schlüssel sind persönlich: Sie handeln als Sie, mit Ihrer Rolle in jedem Projekt, nie mit mehr. Sie können einen Schlüssel auf einen Workspace beschränken, ihm ein Ablaufdatum geben und ihn jederzeit widerrufen; jeder Aufruf wird beim Schlüssel protokolliert.

Scopes

ScopeErlaubt
readplanitude:readProjekte, Vorgänge, Abhängigkeiten, Mitglieder, Kommentare, Basispläne und Webhooks lesen.
writeplanitude:writeAlles aus Lesen, dazu Projekte, Vorgänge, Abhängigkeiten, Kommentare, Basispläne und Webhooks anlegen und ändern.

Schlüssel und OAuth-Apps können keine Projekte oder Vorgänge löschen: Löschen bleibt in der Web-App, wo eine Person es bestätigt. Ein Skript mit der falschen ID kann keinen Plan vernichten.

OAuth 2.1 für Apps von Drittanbietern

Apps, die im Namen anderer Personen handeln, nutzen OAuth 2.1: Authorization Code mit PKCE (S256), Refresh-Tokens, die bei jeder Nutzung rotieren, dynamische Client-Registrierung (RFC 7591). Fordern Sie die Ressource https://planitude.app/api und den Scope planitude:read oder planitude:write an.

Die Endpunkte stehen in den Standard-Discovery-Dokumenten, sodass sich OAuth-Bibliotheken selbst konfigurieren.

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

Bewährte Praktiken

  • Bewahren Sie Schlüssel in Umgebungsvariablen oder einem Secret-Manager auf, nie im Code oder in einem Repository. Schlüssel beginnen mit pln_, damit Secret-Scanner sie erkennen.
  • Nutzen Sie einen Nur-Lese-Schlüssel, wenn Sie nur lesen, und einen Schlüssel pro Integration: So widerrufen Sie einen, ohne die anderen zu stoppen.
  • Geben Sie Schlüsseln für Skripte ein Ablaufdatum und rotieren Sie sie.
  • Rufen Sie die API von Ihrem Server auf, nicht aus dem Browser: Ein Schlüssel im Frontend-Code ist ein öffentlicher Schlüssel.
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"
  ]
}

Fehler

Planitude verwendet die üblichen HTTP-Statuscodes. Fehler haben immer dieselbe JSON-Form: einen stabilen error-Code zum Verzweigen und, wo sinnvoll, details mit dem Grund oder den zu korrigierenden Feldern.

StatusBedeutung
400invalid_requestDie Anfrage ist ungültig: details.fields listet jedes Feld mit dem Problem auf.
401unauthorizedDer Schlüssel fehlt, ist ungültig, widerrufen oder abgelaufen.
403forbiddenSchlüssel oder Rolle erlauben es nicht (details.reason), etwa ein Schreibzugriff mit einem Nur-Lese-Schlüssel oder ein Löschen.
404not_foundNicht gefunden oder für Sie nicht sichtbar.
409dependency_cycleKonflikt mit dem Plan, etwa eine Abhängigkeit, die einen Zyklus schließen würde (dependency_cycle).
429rate_limitedZu viele Anfragen: Warten Sie die Sekunden aus Retry-After ab.
500server_errorFehler auf unserer Seite: Wiederholen Sie mit exponentiellem Backoff.

Error

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

Ratenlimits

Die Limits gelten pro Schlüssel in einem gleitenden Fenster von einer Minute: 240 Lese- und 60 Schreibanfragen. Darüber erhalten Sie 429 rate_limited mit dem Header Retry-After in Sekunden.

Warten Sie Retry-After ab, bevor Sie es erneut versuchen, verteilen Sie Massenarbeiten über die Zeit und fassen Sie viele Änderungen in einem Change Set zusammen: bis zu 1.000 Änderungen in einer Anfrage und einer Neuberechnung.

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

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

Paginierung und Suche

Vorgangslisten werden mit einem Cursor paginiert. Übergeben Sie limit (1–500, Standard 100) und für die nächste Seite den nextCursor der vorherigen Antwort als cursor. Ist nextCursor gleich null, gibt es keine weiteren Seiten.

Filtern Sie mit externalId (exakte Übereinstimmung mit Ihrer eigenen ID), q (Name enthält), updatedSince und completed; sortieren Sie mit sort=-number (neueste zuerst) oder -updatedAt. Kürzere Listen wie Projekte, Mitglieder und Abhängigkeiten kommen vollständig in einer Antwort.

Anfrage
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"

Versionierung

Die API und die Webhook-Payloads sind nach Datum versioniert. Die aktuelle Version ist 2026-10-01: das Feld apiVersion jedes Ereignisses und die info.version des OpenAPI-Dokuments.

Innerhalb einer Version ergänzen wir nur: neue Endpunkte, neue optionale Felder, neue Ereignistypen. Felder werden ohne neue Version nie entfernt oder im Typ geändert, ignorieren Sie also unbekannte Felder.

Anfrage
curl https://planitude.app/api/webhooks/events
Antwort200 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-Referenz

Account

Who is calling, and their workspaces.

User

Attribute

FeldTypBeschreibung
idstring (uuid)
emailstring (email)
namestringkann null sein
avatarUrlstringkann null sein
localestring
emailVerifiedboolean
ObjekteUser
{
  "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
  "email": "anna@example.com",
  "name": "Anna Rossi",
  "avatarUrl": null,
  "locale": "en",
  "emailVerified": true
}

Workspace

Attribute

FeldTypBeschreibung
idstring (uuid)
namestring
rolestring

Einer von: owner, admin, member

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

Current user (connection test)

GET/api/auth/me

Schlüssel mit Leserecht

Rückgabe

200 OK The user

FeldTypBeschreibung
userUser
Anfrage
curl https://planitude.app/api/auth/me \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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

Schlüssel mit Leserecht

Rückgabe

200 OK Workspaces

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

API-Referenz

Projects

Projects, templates and baselines.

Project

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

Attribute

FeldTypBeschreibung
idstring (uuid)
workspaceIdstring (uuid)
keystringProject key, e.g. CRON (task keys are CRON-12).
keyLockedboolean
namestring
descriptionstringkann null sein
startDatestring (date)
calendarIdstring (uuid)kann null sein
currencystring
scheduleFromstring

Einer von: forward, backward

deadlinestring (date)kann null sein
colorstringkann null sein
settingsobject
archivedAtstring (date-time)kann null sein
createdBystring (uuid)kann null sein
createdAtstring (date-time)
updatedAtstring (date-time)
ObjekteProject
{
  "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

Attribute

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

Einer von: builtin, user

namestring
descriptionstringkann null sein
taskCountinteger
durationDaysintegerWorking days from start to finish.
ObjekteTemplate
{
  "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

Attribute

FeldTypBeschreibung
idstring (uuid)
namestring
indexintegerkann null seinNumbered MS Project baseline (1-10); null for the main baseline and the ones you name.
capturedAtstring (date-time)
capturedBystring (uuid)kann null sein
taskCountinteger
ObjekteBaseline
{
  "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

Schlüssel mit Leserecht

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

Query-Parameter

FeldTypBeschreibung
archivedstring

Einer von: 1

Rückgabe

200 OK Projects

FeldTypBeschreibung
projectsarray of Project
Anfrage
curl https://planitude.app/api/projects \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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

Schlüssel mit Schreibrecht

Request-Body

FeldTypBeschreibung
name
Pflicht
string
workspaceIdstring (uuid)Defaults to your personal workspace.
keystring2-5 letters/digits, starts with a letter. Derived from the name if omitted.
descriptionstringkann null sein
startDatestring (date)
deadlinestring (date)kann null sein
currencystring
scheduleFromstring

Einer von: forward, backward

colorstringkann null sein

Rückgabe

201 Created Created

FeldTypBeschreibung
projectProject
Anfrage
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"}'
Antwort201 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

Schlüssel mit Schreibrecht

Request-Body

FeldTypBeschreibung
templateId
Pflicht
stringId from GET /api/templates.
startDate
Pflicht
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)

Rückgabe

201 Created Created

FeldTypBeschreibung
projectProject
taskCountinteger
conflictsarray of Conflict
Anfrage
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"
}'
Antwort201 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

Schlüssel mit Leserecht

Query-Parameter

FeldTypBeschreibung
localestring

Rückgabe

200 OK Templates

FeldTypBeschreibung
templatesarray of Template
Anfrage
curl https://planitude.app/api/templates \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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}

Schlüssel mit Leserecht

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.

Rückgabe

200 OK Project

FeldTypBeschreibung
projectProject
tasksarray of Task
dependenciesarray of Dependency
Anfrage
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8 \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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}

Schlüssel mit Schreibrecht

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.

Request-Body

FeldTypBeschreibung
namestring
descriptionstringkann null sein
startDatestring (date)
deadlinestring (date)kann null sein
currencystring
scheduleFromstring

Einer von: forward, backward

colorstringkann null sein
archivedboolean

Rückgabe

200 OK Updated

FeldTypBeschreibung
projectProject
conflictsarray of Conflict
rescheduledbooleanThe schedule was recalculated (start date, calendar or direction changed).
Anfrage
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"}'
Antwort200 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

Schlüssel mit Leserecht

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).

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.

Query-Parameter

FeldTypBeschreibung
formatstringFile format. mspdi = Microsoft Project XML.

Einer von: mspdi, csv, png, pdf

Standard: mspdi

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

Standard: en

scalestringPNG/PDF: time unit of the columns.

Einer von: auto, day, week, month, quarter

Standard: 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.

Einer von: 0, 1

Standard: 1

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

Einer von: 0, 1

Standard: 1

linksstringPNG/PDF: draw dependency arrows.

Einer von: 0, 1

Standard: 1

paperstringPDF: paper size.

Einer von: a4, a3, letter

Standard: a4

orientationstringPDF: page orientation.

Einer von: landscape, portrait

Standard: landscape

Rückgabe

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

Anfrage
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

Schlüssel mit Leserecht

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.

Rückgabe

200 OK Baselines

FeldTypBeschreibung
baselinesarray of Baseline
Anfrage
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/baseline \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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

Schlüssel mit Schreibrecht

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.

Request-Body

FeldTypBeschreibung
namestring

Rückgabe

201 Created Saved

FeldTypBeschreibung
baselineBaseline
Anfrage
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"}'
Antwort201 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-Referenz

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.

Attribute

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

Einer von: summary, task, milestone

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

Einer von: 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)kann null sein
deadlinestring (date-time)kann null sein
calendarIdstring (uuid)kann null sein
costFixednumber
notesstringkann null sein
colorstringkann null sein
wbsstringkann null sein
externalIdstringkann null seinYour identifier for this task in another system. Searchable with GET /tasks?externalId=.
startAtstring (date-time)kann null seinComputed start.
finishAtstring (date-time)kann null seinComputed finish.
isCriticalbooleanOn the critical path.
totalFloatMinintegerkann null seinTotal float (slack) in working minutes.
earlyStartAtstring (date-time)kann null sein
lateFinishAtstring (date-time)kann null sein
actualStartAtstring (date-time)kann null sein
actualFinishAtstring (date-time)kann null sein
actualDurationMinintegerkann null sein
remainingDurationMinintegerkann null sein
manuallyScheduledboolean
levelingDelayMininteger
taskTypestring

Einer von: fixed_units, fixed_duration, fixed_work, fixed_duration_and_units

effortDrivenboolean
durationOptimisticMinintegerkann null sein
durationPessimisticMinintegerkann null sein
projectIdstring (uuid)
completedbooleanprogressPct = 100.
assigneesarray of Assignee
urlstring (uri)Page of the task in the web app.
ObjekteTask
{
  "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

Attribute

FeldTypBeschreibung
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
Felder von stats anzeigen
FeldTypBeschreibung
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
ObjekteWriteResult
{
  "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

Attribute

FeldTypBeschreibung
idstring (uuid)
taskIdstring (uuid)
userIdstring (uuid)
authorNamestring
authorAvatarUrlstringkann null sein
bodystring
mentionsarray of string
createdAtstring (date-time)
editedAtstring (date-time)kann null sein
ObjekteComment
{
  "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

Schlüssel mit Leserecht

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.

Query-Parameter

FeldTypBeschreibung
limitinteger1-500.

Standard: 100

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

Einer von: number, -number, -updatedAt

Standard: number

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

Einer von: true, false

Rückgabe

200 OK A page of tasks

FeldTypBeschreibung
tasksarray of Task
nextCursorstringkann null sein
Anfrage
curl "https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks?externalId=crm-4711" \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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

Schlüssel mit Schreibrecht

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.

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.

Request-Body

TaskCreate

FeldTypBeschreibung
name
Pflicht
string
parentIdstring (uuid)kann null seinParent (summary) task; null = top level.
afterTaskIdstring (uuid)kann null seinInsert after this sibling.
beforeTaskIdstring (uuid)kann null seinInsert before this sibling.
typestring

Einer von: summary, task, milestone

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

Einer von: 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)kann null sein
deadlinestring (date-time)kann null sein
calendarIdstring (uuid)kann null sein
costFixednumber
notesstringkann null sein
colorstringkann null sein
wbsstringkann null sein
externalIdstringkann null seinYour identifier for this task in another system. Searchable with GET /tasks?externalId=.

oder ChangeSet

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

Rückgabe

201 Created Task created

FeldTypBeschreibung
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
Felder von stats anzeigen
FeldTypBeschreibung
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Anfrage
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"}'
Antwort201 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}

Schlüssel mit Leserecht

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.
taskId
Pflicht
string (uuid)Task id.

Rückgabe

200 OK The task

FeldTypBeschreibung
taskTask
Anfrage
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks/4dbd104a-00cd-4035-8955-255f52ea586a \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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}

Schlüssel mit Schreibrecht

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

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.
taskId
Pflicht
string (uuid)Task id.

Request-Body

FeldTypBeschreibung
namestring
typestring

Einer von: summary, task, milestone

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

Einer von: 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)kann null sein
deadlinestring (date-time)kann null sein
calendarIdstring (uuid)kann null sein
costFixednumber
notesstringkann null sein
colorstringkann null sein
wbsstringkann null sein
externalIdstringkann null seinYour identifier for this task in another system. Searchable with GET /tasks?externalId=.
placementobject
Felder von placement anzeigen
FeldTypBeschreibung
parentIdstring (uuid)kann null seinParent (summary) task; null = top level.
afterTaskIdstring (uuid)kann null seinInsert after this sibling.
beforeTaskIdstring (uuid)kann null seinInsert before this sibling.

Rückgabe

200 OK Updated

FeldTypBeschreibung
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
Felder von stats anzeigen
FeldTypBeschreibung
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Anfrage
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}'
Antwort200 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

Schlüssel mit Leserecht

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.
taskId
Pflicht
string (uuid)Task id.

Rückgabe

200 OK Comments

FeldTypBeschreibung
commentsarray of Comment
Anfrage
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks/4dbd104a-00cd-4035-8955-255f52ea586a/comments \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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

Schlüssel mit Schreibrecht

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.
taskId
Pflicht
string (uuid)Task id.

Request-Body

FeldTypBeschreibung
body
Pflicht
stringPlain text.
mentionsarray of stringUser ids to notify.

Rückgabe

201 Created Created

FeldTypBeschreibung
commentComment
Anfrage
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."}'
Antwort201 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-Referenz

Dependencies

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

Dependency

Attribute

FeldTypBeschreibung
idstring (uuid)
predecessorIdstring (uuid)
successorIdstring (uuid)
typestring

Einer von: FS, SS, FF, SF

lagMinintegerWorking minutes; negative = lead.
ObjekteDependency
{
  "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

Schlüssel mit Leserecht

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.

Rückgabe

200 OK Dependencies

FeldTypBeschreibung
dependenciesarray of Dependency
Anfrage
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/dependencies \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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

Schlüssel mit Schreibrecht

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

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.

Request-Body

DependencyCreate

FeldTypBeschreibung
predecessorId
Pflicht
string (uuid)
successorId
Pflicht
string (uuid)
typestring

Einer von: FS, SS, FF, SF

Standard: FS

lagMininteger

Standard: 0

oder dependencies

FeldTypBeschreibung
dependencies
Pflicht
array of DependencyCreate

Rückgabe

201 Created Created

FeldTypBeschreibung
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
Felder von stats anzeigen
FeldTypBeschreibung
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Anfrage
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
}'
Antwort201 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}

Schlüssel mit Schreibrecht

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.
dependencyId
Pflicht
string (uuid)

Rückgabe

200 OK Removed

FeldTypBeschreibung
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
Felder von stats anzeigen
FeldTypBeschreibung
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Anfrage
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"
Antwort200 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-Referenz

People

Project members and task assignees.

Member

Attribute

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

Einer von: owner, editor, viewer

directRolestringkann null seinRole granted on the project itself (null = only through the workspace).

Einer von: owner, editor, viewer

inheritedbooleanAccess comes from the workspace.
resourceIdstring (uuid)kann null seinResource used when the person is assigned to tasks.
addedAtstring (date-time)
avatarUrlstringkann null sein
ObjekteMember
{
  "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

Attribute

FeldTypBeschreibung
resourceIdstring (uuid)
userIdstring (uuid)kann null sein
namestring
unitsPctinteger
ObjekteAssignee
{
  "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

Schlüssel mit Schreibrecht

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.

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.
taskId
Pflicht
string (uuid)Task id.

Request-Body

FeldTypBeschreibung
userIds
Pflicht
array of string
resourceIdsarray of string

Rückgabe

200 OK Assignees saved

FeldTypBeschreibung
taskIdstring (uuid)
assignmentsarray of object
Felder von assignments anzeigen
FeldTypBeschreibung
idstring (uuid)
taskIdstring (uuid)
resourceIdstring (uuid)
unitsPctinteger
workMininteger
resourcesarray of object
Felder von resources anzeigen
FeldTypBeschreibung
idstring (uuid)
userIdstring (uuid)kann null sein
namestring
kindstring

Einer von: work, material, cost

emailstringkann null sein
costPerHournumber
costPerUsenumber
capacityPctinteger
calendarIdstring (uuid)kann null sein
colorstringkann null sein
avatarUrlstringkann null sein
needsRescheduleboolean
conflictsarray of Conflict
Anfrage
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"]}'
Antwort200 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

Schlüssel mit Leserecht

Pfadparameter

FeldTypBeschreibung
projectId
Pflicht
string (uuid)Project id.

Rückgabe

200 OK Members

FeldTypBeschreibung
membersarray of Member
rolestring
Anfrage
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/members \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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-Referenz

Webhooks

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

Webhook

Attribute

FeldTypBeschreibung
idstring (uuid)
workspaceIdstring (uuid)
workspaceNamestring
projectIdstring (uuid)kann null seinnull = every project of the workspace.
projectNamestringkann null sein
namestring
urlstring (uri)
eventsarray of string

Einer von: 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
disabledReasonstringkann null sein

Einer von: failures, gone, project_deleted, user

disabledAtstring (date-time)kann null sein
consecutiveFailuresinteger
viaApibooleanCreated with the API (REST hook) rather than from the profile.
createdByobjectkann null sein
Felder von createdBy anzeigen
FeldTypBeschreibung
idstring (uuid)
namestringkann null sein
createdAtstring (date-time)
updatedAtstring (date-time)
lastDeliveryAtstring (date-time)kann null sein
lastSuccessAtstring (date-time)kann null sein
ObjekteWebhook
{
  "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

Attribute

FeldTypBeschreibung
idstring (uuid)
eventIdstring (uuid)
eventTypestring
statusstring

Einer von: pending, success, failed, cancelled

attemptsinteger
nextAttemptAtstring (date-time)kann null sein
lastAttemptAtstring (date-time)kann null sein
responseStatusintegerkann null sein
responseExcerptstringkann null sein
errorstringkann null sein
durationMsintegerkann null sein
manualboolean
createdAtstring (date-time)
ObjekteDelivery
{
  "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

Attribute

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

Einer von: 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
Pflicht
string

Einer von: 2026-10-01

createdAt
Pflicht
string (date-time)
workspaceId
Pflicht
string (uuid)
projectIdstring (uuid)kann null sein
actorobjectkann null seinWho made the change (null for system changes).
Felder von actor anzeigen
FeldTypBeschreibung
idstring (uuid)
namestringkann null sein
data
Pflicht
object
ObjekteEvent
{
  "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.

Attribute

FeldTypBeschreibung
idstring (uuid)
workspaceIdstring (uuid)
keystring
namestring
descriptionstringkann null sein
startDatestring (date)
deadlinestring (date)kann null sein
currencystring
scheduleFromstring

Einer von: forward, backward

colorstringkann null sein
archivedboolean
createdAtstring (date-time)
updatedAtstring (date-time)
urlstring (uri)
ObjekteProject (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

Schlüssel mit Leserecht

Query-Parameter

FeldTypBeschreibung
workspaceIdstring (uuid)
projectIdstring (uuid)

Rückgabe

200 OK Subscriptions

FeldTypBeschreibung
webhooksarray of Webhook
Anfrage
curl https://planitude.app/api/webhooks \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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

Schlüssel mit Schreibrecht

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

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

Einer von: 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)

Rückgabe

201 Created Created

FeldTypBeschreibung
webhookWebhook
secretstringwhsec_...
Anfrage
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"
}'
Antwort201 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

Öffentlich, ohne Schlüssel

Rückgabe

200 OK Events

FeldTypBeschreibung
apiVersionstring
eventsarray of string
Anfrage
curl https://planitude.app/api/webhooks/events
Antwort200 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}

Schlüssel mit Leserecht

Pfadparameter

FeldTypBeschreibung
webhookId
Pflicht
string (uuid)Webhook id.

Rückgabe

200 OK Subscription

FeldTypBeschreibung
webhookWebhook
Anfrage
curl https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88 \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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}

Schlüssel mit Schreibrecht

Pfadparameter

FeldTypBeschreibung
webhookId
Pflicht
string (uuid)Webhook id.

Request-Body

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

Rückgabe

200 OK Updated

FeldTypBeschreibung
webhookWebhook
Anfrage
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}'
Antwort200 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}

Schlüssel mit Schreibrecht

Pfadparameter

FeldTypBeschreibung
webhookId
Pflicht
string (uuid)Webhook id.

Rückgabe

204 No Content Deleted

Anfrage
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

Schlüssel mit Leserecht

Pfadparameter

FeldTypBeschreibung
webhookId
Pflicht
string (uuid)Webhook id.

Query-Parameter

FeldTypBeschreibung
limitinteger1-100.

Standard: 50

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

Rückgabe

200 OK Deliveries

FeldTypBeschreibung
deliveriesarray of Delivery
nextCursorstringkann null sein
Anfrage
curl https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/deliveries \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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}

Schlüssel mit Leserecht

Pfadparameter

FeldTypBeschreibung
webhookId
Pflicht
string (uuid)Webhook id.
deliveryId
Pflicht
string (uuid)

Rückgabe

200 OK Payload

FeldTypBeschreibung
payloadEvent
Anfrage
curl https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/deliveries/4b207161-80f9-40bb-bc3f-d8f70315be00 \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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

Schlüssel mit Schreibrecht

Pfadparameter

FeldTypBeschreibung
webhookId
Pflicht
string (uuid)Webhook id.
deliveryId
Pflicht
string (uuid)

Rückgabe

202 Accepted Queued

FeldTypBeschreibung
deliveryDelivery
Anfrage
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"
Antwort202 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

Schlüssel mit Schreibrecht

Pfadparameter

FeldTypBeschreibung
webhookId
Pflicht
string (uuid)Webhook id.

Rückgabe

202 Accepted Queued

FeldTypBeschreibung
deliveryDelivery
Anfrage
curl -X POST https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/test \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort202 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

Schlüssel mit Schreibrecht

Pfadparameter

FeldTypBeschreibung
webhookId
Pflicht
string (uuid)Webhook id.

Rückgabe

200 OK New secret (shown once)

FeldTypBeschreibung
webhookWebhook
secretstring
Anfrage
curl -X POST https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/rotate-secret \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort200 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 senden einen HTTPS-POST mit JSON-Body an Ihren Endpunkt, sobald sich etwas ändert, egal ob die Änderung aus der Web-App, der API, dem MCP-Server oder einem Import kommt. Ein Webhook deckt ein Projekt ab oder alle Projekte eines Workspace (Inhaber und Administratoren).

Legen Sie sie unter Profil → Webhooks an oder per API als REST-Hooks: abonnieren mit POST /api/webhooks, abbestellen mit DELETE. Das Signatur-Secret wird nur einmal angezeigt.

Jede Anfrage enthält diese Header:

HeaderBeschreibung
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
Anfrage
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"
}'
Antwort201 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"
}

Ereignistypen

Abonnieren Sie einzelne Ereignisse oder * für alle. Jedes Ereignis hat denselben Umschlag; data ändert sich mit dem Typ.

EreignisBeschreibung
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.
Beispiel-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": {
    "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"
  }
}

Signaturen prüfen

Jede Anfrage ist mit HMAC-SHA256 und dem Secret Ihres Webhooks signiert. Der Header Planitude-Signature enthält einen Zeitstempel t und die Signatur v1, berechnet über t, einen Punkt und den Roh-Body.

  1. Verwenden Sie den Roh-Body vor jedem JSON-Parsing: Ein neu serialisierter Body hat eine andere Signatur.
  2. Berechnen Sie den HMAC und vergleichen Sie ihn in konstanter Zeit.
  3. Lehnen Sie Anfragen ab, deren Zeitstempel mehr als 5 Minuten von Ihrer Uhr abweicht: Eine abgefangene Anfrage lässt sich nicht wiederholen.
  4. Rotieren Sie das Secret jederzeit: Das alte funktioniert sofort nicht mehr.
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
// });

Wiederholungen und Zustellung

Antworten Sie innerhalb von 10 Sekunden mit einem beliebigen 2xx und erledigen Sie die eigentliche Arbeit danach in einer Warteschlange. Weiterleitungen werden nicht verfolgt. Bei Fehlern und Timeouts versucht Planitude es insgesamt bis zu 6-mal: sofort, dann nach 1 min, 5 min, 30 min, 2 h, 12 h.

Die Zustellung erfolgt mindestens einmal und ohne Reihenfolge. Speichern Sie die Ereignis-ID (Planitude-Event-Id, auch id im Body) und überspringen Sie bereits verarbeitete; sortieren Sie nach createdAt.

Scheitern 5 Ereignisse hintereinander bei jedem Versuch, wird der Webhook deaktiviert und sein Inhaber per E-Mail informiert. Eine Antwort 410 Gone deaktiviert ihn sofort. Aktivieren Sie ihn im Profil wieder oder mit PATCH und active: true.

Das Zustellprotokoll (Status, HTTP-Code, Antwortauszug, Payload, manuelles erneutes Senden) wird 30 Tage aufbewahrt. Als Ziel sind nur öffentliche Adressen erlaubt.

Wiederholungsplan6 × POST
Versuch 1   sofort
Versuch 2   + 1 min
Versuch 3   + 5 min
Versuch 4   + 30 min
Versuch 5   + 2 h
Versuch 6   + 12 h

Endpunkt testen

  1. Senden Sie ein Ereignis webhook.ping mit dem Test-Endpunkt oder mit der Schaltfläche Testen im Profil.
  2. Um Ereignisse auf Ihrem Rechner zu empfangen, machen Sie Ihren lokalen Server per Tunnel erreichbar (etwa ngrok oder Cloudflare Tunnel) und abonnieren Sie dessen öffentliche HTTPS-Adresse.
  3. Im Zustellprotokoll sehen Sie Status, HTTP-Code und Antwort; senden Sie eine Zustellung erneut, sobald Ihr Endpunkt korrigiert ist.
Anfrage
curl -X POST https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/test \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Antwort202 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"
  }
}

KI und MCP

MCP-Server

Planitude ist ein MCP-Server (Model Context Protocol): KI-Assistenten und Code-Editoren lesen Projekte, analysieren kritischen Pfad und Auslastung und legen Vorgänge an oder ändern sie, mit Ihren Rechten. Web-Apps verbinden sich per OAuth (Sie melden sich an und erlauben den Zugriff); Kommandozeilen-Tools und Editoren nutzen einen API-Schlüssel.

Server-URL

https://planitude.app/mcp

  • ChatGPTOAuth

    Öffnen Sie in ChatGPT Einstellungen › Sicherheit und Anmeldung und aktivieren Sie den Entwicklermodus. Legen Sie eine App mit der Server-URL und OAuth-Authentifizierung an, melden Sie sich dann bei Planitude an und erlauben Sie den Zugriff.

    Offizielle Dokumentation ↗
  • ClaudeOAuth

    Öffnen Sie Anpassen › Konnektoren › Benutzerdefinierten Konnektor hinzufügen, fügen Sie die Server-URL ein und wählen Sie Verbinden: Planitude öffnet sich, Sie melden sich an und erlauben den Zugriff. Funktioniert in claude.ai, Claude Desktop und der mobilen App.

    Offizielle Dokumentation ↗
  • GeminiOAuth

    Öffnen Sie auf gemini.google.com Einstellungen › Verbundene Apps, wählen Sie Benutzerdefinierte App hinzufügen und fügen Sie die Server-URL ein; melden Sie sich dann bei Planitude an und erlauben Sie den Zugriff.

    Offizielle Dokumentation ↗
  • Claude CodeAPI-Schlüssel

    Führen Sie den Befehl mit dem Schlüssel in einer Umgebungsvariablen aus. Mit --scope user gilt er in allen Projekten; prüfen Sie mit claude mcp list.

    Offizielle Dokumentation ↗
  • CodexAPI-Schlüssel

    Legen Sie den Schlüssel in PLANITUDE_API_KEY ab und ergänzen Sie den Block in ~/.codex/config.toml: Er gilt für CLI, App und IDE-Erweiterung.

    Offizielle Dokumentation ↗
  • CursorAPI-Schlüssel

    Ergänzen Sie den Block in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein Projekt); Cursor liest den Schlüssel aus der Umgebung.

    Offizielle Dokumentation ↗
  • Visual Studio CodeAPI-Schlüssel

    Fügen Sie .vscode/mcp.json zum Workspace hinzu: VS Code fragt einmal nach dem Schlüssel und speichert ihn sicher außerhalb der Datei.

    Offizielle Dokumentation ↗
  • Gemini CLIAPI-Schlüssel

    Führen Sie den Befehl mit dem Schlüssel in einer Umgebungsvariablen aus oder ergänzen Sie den Block in ~/.gemini/settings.json.

    Offizielle Dokumentation ↗

Werkzeuge

Der Server bietet 29 Werkzeuge, vom Lesen und Analysieren bis zu sicheren Änderungen. Keines löscht Projekte oder Vorgänge.

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

KI-Agenten

Füge bis zu 5 externe KI-Agenten als Mitglieder zum Workspace hinzu: Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot oder jeden MCP-Client. Weise ihnen Aufgaben zu, erwähne sie in Kommentaren und prüfe ihre Änderungen.

Owner und Admins erstellen Agentenschlüssel unter Agenten, Tab Verbindung. Ein Schlüssel beginnt mit pln_, wird einmal angezeigt und nur als Hash gespeichert; jeder Agent hat bis zu 2 Schlüssel, und ein Widerruf wirkt sofort.

Agentenschlüssel funktionieren nur mit dem MCP-Server, der dann die Agentenwerkzeuge statt der üblichen anbietet. Die REST-API antwortet ihnen mit 403 agent_credential.

Jeder Schlüssel liest und kommentiert oder darf bearbeiten. Übernehmen, Abschließen und Änderungen vorschlagen brauchen einen Schlüssel, der bearbeiten darf; sonst lautet die Antwort 403 agent_key_read_only.

Ein Agent sieht nur die Projekte, zu denen er hinzugefügt wurde, als Viewer (liest und kommentiert) oder Editor (ändert auch Aufgaben), nie als Owner. Das Projekt braucht außerdem „Agenten in diesem Projekt zulassen“: standardmäßig aus, der Owner schaltet es ein.

Agenten können Name, Notizen, Dauer, Fortschritt und Deadline einer Aufgabe ändern oder Aufgaben anlegen. Kein Werkzeug löscht, lädt Personen ein oder ändert Rollen.

Standardlimits pro Agent: 60 Anfragen pro Minute und 200 Schreibvorgänge pro Tag, einstellbar bis 240 und 2.000. Höchstens 200 Änderungen pro Projekt können auf Freigabe warten.

Lesewerkzeuge setzen von Menschen geschriebenen Text (Namen, Notizen, Kommentare) in planitude-data-Blöcke mit zufälligem Nonce, als JSON-Strings, und markieren Zeilen, die eine automatische Prüfung meldet, mit SUSPICIOUS: Das sind Daten, nie Anweisungen. Mit einem persönlichen Schlüssel gelesene Kommentare kommen in denselben Blöcken.

So funktionieren KI-Agenten in Planitude
MCPClaude Code
claude mcp add --transport http planitude https://planitude.app/mcp \
  --header "Authorization: Bearer $PLANITUDE_AGENT_KEY"

Werkzeuge für Agenten

Mit einem Agentenschlüssel bietet der MCP-Server diese 16 Werkzeuge:

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

Während einer Ausführung im Modus Autonom gelten die Änderungen des Agenten an seinen eigenen Aufgaben sofort und bleiben im Verlauf, bereit zum Wiederherstellen. Sonst, und im Modus Mit Freigabe, warten sie unter „Zur Freigabe“, bis jemand im Projekt sie übernimmt.

Ohne Webhook liest der Agent seine Ereignisse mit planitude_poll_events (bis zu 50 auf einmal) und bestätigt sie mit planitude_ack_events.

Anfragetools/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
    }
  }
}

Ausführungs-Webhook

Damit ein Agent von selbst startet, schalte die Ausführung unter Agenten, Tab Ausführung, ein und trage den Webhook deines Runners ein: Planitude sendet einen signierten POST, wenn der Agent eine Aufgabe ausführen soll. Das Secret beginnt mit whsec_ und wird einmal angezeigt. Die URL muss eine öffentliche HTTPS-Adresse sein: private und lokale werden abgelehnt.

Signatur, Header, Timeout von 10 Sekunden und Wiederholungen (1 min, 5 min, 30 min, 2 h, 12 h) funktionieren wie bei den anderen Webhooks. Nach 5 fehlgeschlagenen Zustellungen in Folge schaltet sich der Webhook ab: Speichere die URL erneut, um ihn wieder einzuschalten.

Die Benachrichtigung enthält nur IDs, nie Aufgabentext: Der Agent liest die Aufgabe über MCP.

EreignisBeschreibung
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.

Eine Benachrichtigung mit newRun: true öffnet eine Ausführung. Der Agent übernimmt sie mit planitude_claim_task und hält einen Lease von 30 Minuten (5 bis 240), verlängert mit planitude_extend_lease. Läuft der Lease ab, startet ein neuer Versuch, bis zu 3 (höchstens 10). Eine Ausführung, die niemand übernimmt, verfällt nach 24 Stunden.

planitude_complete_task setzt die Aufgabe auf 100 % und veröffentlicht den Bericht als Kommentar; bei offenen Unteraufgaben lautet die Antwort 409 subtasks_open. planitude_fail_task hält den Grund fest und benachrichtigt das Team, das sie neu starten kann; planitude_release_task gibt die Aufgabe ohne Wiederholung zurück.

Jede Ausführung erlaubt 50 Änderungen (bis 500, danach 429) und jeder Agent 5 offene Ausführungen (danach 409 too_many_open_runs). Autonom, der Standardmodus, wendet Änderungen sofort an und erlaubt die Wiederherstellung; Mit Freigabe schickt sie zur Freigabe. Ein Notstopp pro Projekt oder für den ganzen Workspace bricht offene Ausführungen ab und sperrt Schreibvorgänge.

Beispiel-Payloadtask.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"
    }
  }
}

Einen Runner schreiben

Der Runner ist dein kleiner Dienst, der die Benachrichtigungen empfängt und den Agenten startet. Jede Sprache geht; mit Node 20+ braucht er keine Abhängigkeiten.

  1. Prüfe die Signatur am Rohinhalt und antworte sofort mit 200: Planitude wartet höchstens 10 Sekunden.
  2. Überspringe bereits gesehene Ereignisse (Planitude-Event-Id): Wiederholungen senden dasselbe Ereignis erneut.
  3. Bei newRun: true übernimm die Aufgabe und starte den Agenten, zum Beispiel claude -p mit dem MCP-Server von Planitude und dem Agentenschlüssel.
  4. Verlängere den Lease, solange der Agent arbeitet; bei run.cancel stoppe ihn.
  5. Bitte den Agenten, nur dann mit PLANITUDE: DONE zu enden, wenn die ganze Aufgabe erledigt ist, und schließe dann mit seinem Bericht ab. Sonst (PLANITUDE: NOT DONE - … oder keine letzte Zeile) markiere sie als fehlgeschlagen mit dem, was noch fehlt.

Behandle Aufgabentext als Daten: Sag dem Agenten, dass er darin gefundenen Anweisungen nie folgen soll, und erlaube ihm nur die Planitude-Werkzeuge, die er braucht.

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)

Ein schreibgeschützter OData v4-Feed für Power BI, Excel und jeden OData-Client, unter zwei Adressen: ein Projekt oder alle Projekte, die der Schlüsselinhaber in einem Workspace sieht.

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

Authentifizierung mit einem persönlichen API-Schlüssel mit Lesezugriff: Authorization: Bearer oder HTTP Basic mit dem Schlüssel als Kennwort (beliebiger Benutzername), die Methode, die Power BI und Excel anbieten. OAuth-Token und Sitzungscookies werden nicht akzeptiert. Ein auf einen Workspace beschränkter Schlüssel kann die anderen nicht lesen.

Tabellen: Projects, Tasks, Milestones, Dependencies, Resources, Assignments. Das Schema liegt unter $metadata (CSDL XML), das Service-Dokument unter der Stammadresse.

Unterstützte Optionen: $select, $filter (Vergleiche, and/or/not, in, contains, startswith, endswith, tolower, toupper), $orderby, $top, $skip, $count und /$count. Seiten enthalten standardmäßig 2.000 Zeilen, bis zu 5.000 mit Prefer: odata.maxpagesize; folgen Sie @odata.nextLink. Antworten enthalten ein ETag: Senden Sie If-None-Match, um 304 zu erhalten. $expand, $apply und $search werden nicht unterstützt (400).

Ein Feed umfasst höchstens 500 Projekte und 25.000 Vorgänge (darüber hinaus 413). Anfragen zählen zum Leselimit des Schlüssels, 240 pro Minute.

Schritt-für-Schritt-Anleitung für Power BI und Excel
AnfragecURL
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"
Antwort200 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
    }
  ]
}

Änderungen

  1. Neuer schreibgeschützter OData v4-Feed unter /api/odata/projects/:projectId und /api/odata/workspaces/:workspaceId für Power BI, Excel und andere OData-Clients: sechs Tabellen, $metadata, $select, $filter, $orderby, $top, $skip, $count, serverseitige Seitenaufteilung und ETag.

  2. Neuer Endpunkt GET /api/projects/:projectId/export: der Plan als Microsoft Project XML, CSV, PNG-Bild oder PDF, mit Optionen für Skala, Zeitraum, kritischen Pfad, Basisplan, Abhängigkeiten, Papierformat und Ausrichtung.

  3. Alle API-Schlüssel beginnen jetzt mit pln_. Schlüssel, die mit gnt_ beginnen, funktionieren nicht mehr: Erstelle einen neuen.

  4. Agenten führen Aufgaben aus: signierter Ausführungs-Webhook (task.assigned, task.start_due, task.due_today, task.overdue, run.retry, run.cancel), 6 Ausführungswerkzeuge mit Lease und eine Anleitung zum Schreiben eines Runners.

  5. MCP-Lesewerkzeuge verpacken von Menschen geschriebenen Text in planitude-data-Blöcke mit Nonce, als JSON-Strings mit SUSPICIOUS-Markierung, für jede Art von Schlüssel.

  6. KI-Agenten als Workspace-Mitglieder: Agentenschlüssel, die nur mit dem MCP-Server funktionieren, 10 Werkzeuge zum Lesen, Kommentieren und Vorschlagen von Änderungen sowie eine Ereigniswarteschlange.

  7. Neue Entwicklerdokumentation, generiert aus dem OpenAPI-Dokument. Das OpenAPI-Dokument beschreibt jetzt alle Felder, die für Mitglieder, Kommentare, Basispläne, Vorlagen und Zuweisungen zurückkommen.

  8. API-Version 2026-10-01: signierte ausgehende Webhooks, dokumentierte öffentliche REST-API (OpenAPI 3.1), Cursor-Paginierung und Suche nach externalId.

  9. OAuth 2.1 für den MCP-Server und die API: ChatGPT, Claude und Gemini verbinden sich, ohne einen Schlüssel zu kopieren.

  10. MCP-Server und persönliche API-Schlüssel mit Lese- oder Lese- und Schreibrecht.

Werbung hält Planitude kostenlos