Dla programistów

Twórz z Planitude

API REST, podpisane webhooki i serwer MCP: utrzymuj swoje systemy w zgodzie z planem, reaguj na każdą zmianę i pozwól asystentowi AI pracować nad Twoimi projektami.

Kod, nazwy pól i dokumentacja techniczna są po angielsku, jak w większości dokumentacji API.

Bazowy URL: https://planitude.app

Żądania i odpowiedzi to JSON przez HTTPS. Czasy trwania i opóźnienia są w minutach roboczych (8-godzinny dzień to 480), momenty w ISO 8601 UTC, daty bez godziny jako YYYY-MM-DD.

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

Szybki start

Od zera do pierwszego webhooka w trzech krokach. Wystarczy terminal.

  1. Utwórz klucz API

    Otwórz Profil → Klucze API, wybierz Odczyt i zapis i skopiuj klucz: zaczyna się od pln_ i jest pokazywany tylko raz. Trzymaj go w zmiennej środowiskowej.

  2. Wykonaj pierwsze wywołanie

    Wyświetl listę projektów, które widzisz. Klucz działa jako Ty: te same projekty, te same role.

  3. Odbierz webhook

    Zasubskrybuj publiczny endpoint HTTPS na potrzebne zdarzenia, od razu wyślij zdarzenie testowe i zweryfikuj jego podpis.

1Terminal
export PLANITUDE_API_KEY="pln_…"
2
curl https://planitude.app/api/projects \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Oczekiwany wynik200 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"
}'
Przykładowy 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"
      ]
    }
  }
}

Uwierzytelnianie

Uwierzytelniaj każde żądanie osobistym kluczem API w nagłówku Authorization, jako bearer token. Klucze są osobiste: działają jako Ty, z Twoją rolą w każdym projekcie, nigdy więcej. Klucz możesz ograniczyć do jednego workspace, nadać mu datę ważności i w każdej chwili unieważnić; każde wywołanie jest zapisywane przy kluczu.

Scope’y

ScopePozwala
readplanitude:readOdczyt projektów, zadań, zależności, członków, komentarzy, planów bazowych i webhooków.
writeplanitude:writeWszystko z odczytu oraz tworzenie i zmiana projektów, zadań, zależności, komentarzy, planów bazowych i webhooków.

Klucze i aplikacje OAuth nie mogą usuwać projektów ani zadań: usuwanie zostaje w aplikacji webowej, gdzie potwierdza je człowiek. Skrypt z błędnym id nie wyczyści planu.

OAuth 2.1 dla aplikacji zewnętrznych

Aplikacje działające w imieniu innych osób używają OAuth 2.1: authorization code z PKCE (S256), refresh tokeny rotowane przy każdym użyciu, dynamiczna rejestracja klientów (RFC 7591). Poproś o zasób https://planitude.app/api i scope planitude:read lub planitude:write.

Endpointy są opublikowane w standardowych dokumentach discovery, więc biblioteki OAuth konfigurują się same.

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

Dobre praktyki

  • Trzymaj klucze w zmiennych środowiskowych lub menedżerze sekretów, nigdy w kodzie ani w repozytorium. Klucze zaczynają się od pln_, więc skanery sekretów je rozpoznają.
  • Używaj klucza tylko do odczytu, gdy tylko czytasz, i osobnego klucza dla każdej integracji: unieważnisz jeden bez zatrzymywania pozostałych.
  • Nadaj kluczom używanym przez skrypty datę ważności i regularnie je wymieniaj.
  • Wywołuj API ze swojego serwera, nie z przeglądarki: klucz w kodzie front-endu to klucz publiczny.
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"
  ]
}

Błędy

Planitude używa standardowych kodów statusu HTTP. Błędy mają zawsze ten sam kształt JSON: stały kod error, na podstawie którego decydujesz, i w razie potrzeby details z powodem lub polami do poprawy.

StatusZnaczenie
400invalid_requestŻądanie jest nieprawidłowe: details.fields wymienia każde pole i problem.
401unauthorizedBrak klucza albo klucz jest nieprawidłowy, unieważniony lub wygasł.
403forbiddenKlucz lub Twoja rola na to nie pozwalają (details.reason), np. zapis kluczem tylko do odczytu albo usuwanie.
404not_foundNie znaleziono lub niewidoczne dla Ciebie.
409dependency_cycleKonflikt z planem, np. zależność, która zamknęłaby cykl (dependency_cycle).
429rate_limitedZa dużo żądań: odczekaj liczbę sekund z Retry-After.
500server_errorBłąd po naszej stronie: ponów z wykładniczym odstępem.

Error

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

Limity zapytań

Limity obowiązują na klucz, w przesuwanym oknie jednej minuty: 240 żądań odczytu i 60 żądań zapisu. Po przekroczeniu dostajesz 429 rate_limited z nagłówkiem Retry-After w sekundach.

Odczekaj Retry-After przed ponowieniem, rozkładaj masowe operacje w czasie i grupuj wiele zmian w jednym change secie: do 1000 zmian w jednym żądaniu i jednym przeliczeniu.

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

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

Paginacja i wyszukiwanie

Listy zadań są stronicowane kursorem. Przekaż limit (1–500, domyślnie 100), a dla kolejnej strony nextCursor z poprzedniej odpowiedzi jako cursor. Gdy nextCursor ma wartość null, nie ma więcej stron.

Filtruj przez externalId (dokładne dopasowanie do Twojego identyfikatora), q (nazwa zawiera), updatedSince i completed; sortuj przez sort=-number (najnowsze najpierw) lub -updatedAt. Krótsze listy, jak projekty, członkowie i zależności, przychodzą w całości w jednej odpowiedzi.

Żądanie
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"

Wersje

API i payloady webhooków mają wersje oznaczone datą. Bieżąca wersja to 2026-10-01: pole apiVersion każdego zdarzenia i info.version dokumentu OpenAPI.

W ramach wersji tylko dodajemy: nowe endpointy, nowe pola opcjonalne, nowe typy zdarzeń. Pola nigdy nie są usuwane ani nie zmieniają typu bez nowej wersji, więc ignoruj pola, których nie znasz.

Żądanie
curl https://planitude.app/api/webhooks/events
Odpowiedź200 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"
  ]
}

Dokumentacja API

Account

Who is calling, and their workspaces.

User

Atrybuty

PoleTypOpis
idstring (uuid)
emailstring (email)
namestringmoże być null
avatarUrlstringmoże być null
localestring
emailVerifiedboolean
ObiektyUser
{
  "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
  "email": "anna@example.com",
  "name": "Anna Rossi",
  "avatarUrl": null,
  "locale": "en",
  "emailVerified": true
}

Workspace

Atrybuty

PoleTypOpis
idstring (uuid)
namestring
rolestring

Jedno z: owner, admin, member

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

Current user (connection test)

GET/api/auth/me

Klucz z prawem odczytu

Zwraca

200 OK The user

PoleTypOpis
userUser
Żądanie
curl https://planitude.app/api/auth/me \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź200 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

Klucz z prawem odczytu

Zwraca

200 OK Workspaces

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

Dokumentacja API

Projects

Projects, templates and baselines.

Project

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

Atrybuty

PoleTypOpis
idstring (uuid)
workspaceIdstring (uuid)
keystringProject key, e.g. CRON (task keys are CRON-12).
keyLockedboolean
namestring
descriptionstringmoże być null
startDatestring (date)
calendarIdstring (uuid)może być null
currencystring
scheduleFromstring

Jedno z: forward, backward

deadlinestring (date)może być null
colorstringmoże być null
settingsobject
archivedAtstring (date-time)może być null
createdBystring (uuid)może być null
createdAtstring (date-time)
updatedAtstring (date-time)
ObiektyProject
{
  "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

Atrybuty

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

Jedno z: builtin, user

namestring
descriptionstringmoże być null
taskCountinteger
durationDaysintegerWorking days from start to finish.
ObiektyTemplate
{
  "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

Atrybuty

PoleTypOpis
idstring (uuid)
namestring
indexintegermoże być nullNumbered MS Project baseline (1-10); null for the main baseline and the ones you name.
capturedAtstring (date-time)
capturedBystring (uuid)może być null
taskCountinteger
ObiektyBaseline
{
  "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

Klucz z prawem odczytu

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

Parametry zapytania

PoleTypOpis
archivedstring

Jedno z: 1

Zwraca

200 OK Projects

PoleTypOpis
projectsarray of Project
Żądanie
curl https://planitude.app/api/projects \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź200 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

Klucz z prawem zapisu

Treść żądania

PoleTypOpis
name
wymagane
string
workspaceIdstring (uuid)Defaults to your personal workspace.
keystring2-5 letters/digits, starts with a letter. Derived from the name if omitted.
descriptionstringmoże być null
startDatestring (date)
deadlinestring (date)może być null
currencystring
scheduleFromstring

Jedno z: forward, backward

colorstringmoże być null

Zwraca

201 Created Created

PoleTypOpis
projectProject
Żądanie
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"}'
Odpowiedź201 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

Klucz z prawem zapisu

Treść żądania

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

Zwraca

201 Created Created

PoleTypOpis
projectProject
taskCountinteger
conflictsarray of Conflict
Żądanie
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"
}'
Odpowiedź201 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

Klucz z prawem odczytu

Parametry zapytania

PoleTypOpis
localestring

Zwraca

200 OK Templates

PoleTypOpis
templatesarray of Template
Żądanie
curl https://planitude.app/api/templates \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź200 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}

Klucz z prawem odczytu

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.

Zwraca

200 OK Project

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

Klucz z prawem zapisu

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.

Treść żądania

PoleTypOpis
namestring
descriptionstringmoże być null
startDatestring (date)
deadlinestring (date)może być null
currencystring
scheduleFromstring

Jedno z: forward, backward

colorstringmoże być null
archivedboolean

Zwraca

200 OK Updated

PoleTypOpis
projectProject
conflictsarray of Conflict
rescheduledbooleanThe schedule was recalculated (start date, calendar or direction changed).
Żądanie
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"}'
Odpowiedź200 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

Klucz z prawem odczytu

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

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.

Parametry zapytania

PoleTypOpis
formatstringFile format. mspdi = Microsoft Project XML.

Jedno z: mspdi, csv, png, pdf

Domyślnie: mspdi

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

Domyślnie: en

scalestringPNG/PDF: time unit of the columns.

Jedno z: auto, day, week, month, quarter

Domyślnie: 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.

Jedno z: 0, 1

Domyślnie: 1

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

Jedno z: 0, 1

Domyślnie: 1

linksstringPNG/PDF: draw dependency arrows.

Jedno z: 0, 1

Domyślnie: 1

paperstringPDF: paper size.

Jedno z: a4, a3, letter

Domyślnie: a4

orientationstringPDF: page orientation.

Jedno z: landscape, portrait

Domyślnie: landscape

Zwraca

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

Żądanie
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

Klucz z prawem odczytu

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.

Zwraca

200 OK Baselines

PoleTypOpis
baselinesarray of Baseline
Żądanie
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/baseline \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź200 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

Klucz z prawem zapisu

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.

Treść żądania

PoleTypOpis
namestring

Zwraca

201 Created Saved

PoleTypOpis
baselineBaseline
Żądanie
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"}'
Odpowiedź201 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
  }
}

Dokumentacja API

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.

Atrybuty

PoleTypOpis
idstring (uuid)
numberintegerSequential number in the project, never reused.
keystringHuman key, e.g. CRON-12.
parentIdstring (uuid)może być null
namestring
typestring

Jedno z: summary, task, milestone

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

Jedno z: 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)może być null
deadlinestring (date-time)może być null
calendarIdstring (uuid)może być null
costFixednumber
notesstringmoże być null
colorstringmoże być null
wbsstringmoże być null
externalIdstringmoże być nullYour identifier for this task in another system. Searchable with GET /tasks?externalId=.
startAtstring (date-time)może być nullComputed start.
finishAtstring (date-time)może być nullComputed finish.
isCriticalbooleanOn the critical path.
totalFloatMinintegermoże być nullTotal float (slack) in working minutes.
earlyStartAtstring (date-time)może być null
lateFinishAtstring (date-time)może być null
actualStartAtstring (date-time)może być null
actualFinishAtstring (date-time)może być null
actualDurationMinintegermoże być null
remainingDurationMinintegermoże być null
manuallyScheduledboolean
levelingDelayMininteger
taskTypestring

Jedno z: fixed_units, fixed_duration, fixed_work, fixed_duration_and_units

effortDrivenboolean
durationOptimisticMinintegermoże być null
durationPessimisticMinintegermoże być null
projectIdstring (uuid)
completedbooleanprogressPct = 100.
assigneesarray of Assignee
urlstring (uri)Page of the task in the web app.
ObiektyTask
{
  "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

Atrybuty

PoleTypOpis
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
Pokaż pola stats
PoleTypOpis
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
ObiektyWriteResult
{
  "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

Atrybuty

PoleTypOpis
idstring (uuid)
taskIdstring (uuid)
userIdstring (uuid)
authorNamestring
authorAvatarUrlstringmoże być null
bodystring
mentionsarray of string
createdAtstring (date-time)
editedAtstring (date-time)może być null
ObiektyComment
{
  "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

Klucz z prawem odczytu

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.

Parametry zapytania

PoleTypOpis
limitinteger1-500.

Domyślnie: 100

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

Jedno z: number, -number, -updatedAt

Domyślnie: number

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

Jedno z: true, false

Zwraca

200 OK A page of tasks

PoleTypOpis
tasksarray of Task
nextCursorstringmoże być null
Żądanie
curl "https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks?externalId=crm-4711" \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź200 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

Klucz z prawem zapisu

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.

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.

Treść żądania

TaskCreate

PoleTypOpis
name
wymagane
string
parentIdstring (uuid)może być nullParent (summary) task; null = top level.
afterTaskIdstring (uuid)może być nullInsert after this sibling.
beforeTaskIdstring (uuid)może być nullInsert before this sibling.
typestring

Jedno z: summary, task, milestone

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

Jedno z: 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)może być null
deadlinestring (date-time)może być null
calendarIdstring (uuid)może być null
costFixednumber
notesstringmoże być null
colorstringmoże być null
wbsstringmoże być null
externalIdstringmoże być nullYour identifier for this task in another system. Searchable with GET /tasks?externalId=.

lub ChangeSet

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

Zwraca

201 Created Task created

PoleTypOpis
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
Pokaż pola stats
PoleTypOpis
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Żądanie
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"}'
Odpowiedź201 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}

Klucz z prawem odczytu

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.
taskId
wymagane
string (uuid)Task id.

Zwraca

200 OK The task

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

Klucz z prawem zapisu

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

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.
taskId
wymagane
string (uuid)Task id.

Treść żądania

PoleTypOpis
namestring
typestring

Jedno z: summary, task, milestone

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

Jedno z: 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)może być null
deadlinestring (date-time)może być null
calendarIdstring (uuid)może być null
costFixednumber
notesstringmoże być null
colorstringmoże być null
wbsstringmoże być null
externalIdstringmoże być nullYour identifier for this task in another system. Searchable with GET /tasks?externalId=.
placementobject
Pokaż pola placement
PoleTypOpis
parentIdstring (uuid)może być nullParent (summary) task; null = top level.
afterTaskIdstring (uuid)może być nullInsert after this sibling.
beforeTaskIdstring (uuid)może być nullInsert before this sibling.

Zwraca

200 OK Updated

PoleTypOpis
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
Pokaż pola stats
PoleTypOpis
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Żądanie
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}'
Odpowiedź200 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

Klucz z prawem odczytu

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.
taskId
wymagane
string (uuid)Task id.

Zwraca

200 OK Comments

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

Klucz z prawem zapisu

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.
taskId
wymagane
string (uuid)Task id.

Treść żądania

PoleTypOpis
body
wymagane
stringPlain text.
mentionsarray of stringUser ids to notify.

Zwraca

201 Created Created

PoleTypOpis
commentComment
Żądanie
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."}'
Odpowiedź201 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
  }
}

Dokumentacja API

Dependencies

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

Dependency

Atrybuty

PoleTypOpis
idstring (uuid)
predecessorIdstring (uuid)
successorIdstring (uuid)
typestring

Jedno z: FS, SS, FF, SF

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

Klucz z prawem odczytu

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.

Zwraca

200 OK Dependencies

PoleTypOpis
dependenciesarray of Dependency
Żądanie
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/dependencies \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź200 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

Klucz z prawem zapisu

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

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.

Treść żądania

DependencyCreate

PoleTypOpis
predecessorId
wymagane
string (uuid)
successorId
wymagane
string (uuid)
typestring

Jedno z: FS, SS, FF, SF

Domyślnie: FS

lagMininteger

Domyślnie: 0

lub dependencies

PoleTypOpis
dependencies
wymagane
array of DependencyCreate

Zwraca

201 Created Created

PoleTypOpis
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
Pokaż pola stats
PoleTypOpis
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Żądanie
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
}'
Odpowiedź201 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}

Klucz z prawem zapisu

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.
dependencyId
wymagane
string (uuid)

Zwraca

200 OK Removed

PoleTypOpis
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
Pokaż pola stats
PoleTypOpis
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Żądanie
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"
Odpowiedź200 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
  }
}

Dokumentacja API

People

Project members and task assignees.

Member

Atrybuty

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

Jedno z: owner, editor, viewer

directRolestringmoże być nullRole granted on the project itself (null = only through the workspace).

Jedno z: owner, editor, viewer

inheritedbooleanAccess comes from the workspace.
resourceIdstring (uuid)może być nullResource used when the person is assigned to tasks.
addedAtstring (date-time)
avatarUrlstringmoże być null
ObiektyMember
{
  "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

Atrybuty

PoleTypOpis
resourceIdstring (uuid)
userIdstring (uuid)może być null
namestring
unitsPctinteger
ObiektyAssignee
{
  "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

Klucz z prawem zapisu

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.

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.
taskId
wymagane
string (uuid)Task id.

Treść żądania

PoleTypOpis
userIds
wymagane
array of string
resourceIdsarray of string

Zwraca

200 OK Assignees saved

PoleTypOpis
taskIdstring (uuid)
assignmentsarray of object
Pokaż pola assignments
PoleTypOpis
idstring (uuid)
taskIdstring (uuid)
resourceIdstring (uuid)
unitsPctinteger
workMininteger
resourcesarray of object
Pokaż pola resources
PoleTypOpis
idstring (uuid)
userIdstring (uuid)może być null
namestring
kindstring

Jedno z: work, material, cost

emailstringmoże być null
costPerHournumber
costPerUsenumber
capacityPctinteger
calendarIdstring (uuid)może być null
colorstringmoże być null
avatarUrlstringmoże być null
needsRescheduleboolean
conflictsarray of Conflict
Żądanie
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"]}'
Odpowiedź200 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

Klucz z prawem odczytu

Parametry ścieżki

PoleTypOpis
projectId
wymagane
string (uuid)Project id.

Zwraca

200 OK Members

PoleTypOpis
membersarray of Member
rolestring
Żądanie
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/members \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź200 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"
}

Dokumentacja API

Webhooks

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

Webhook

Atrybuty

PoleTypOpis
idstring (uuid)
workspaceIdstring (uuid)
workspaceNamestring
projectIdstring (uuid)może być nullnull = every project of the workspace.
projectNamestringmoże być null
namestring
urlstring (uri)
eventsarray of string

Jedno z: 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
disabledReasonstringmoże być null

Jedno z: failures, gone, project_deleted, user

disabledAtstring (date-time)może być null
consecutiveFailuresinteger
viaApibooleanCreated with the API (REST hook) rather than from the profile.
createdByobjectmoże być null
Pokaż pola createdBy
PoleTypOpis
idstring (uuid)
namestringmoże być null
createdAtstring (date-time)
updatedAtstring (date-time)
lastDeliveryAtstring (date-time)może być null
lastSuccessAtstring (date-time)może być null
ObiektyWebhook
{
  "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

Atrybuty

PoleTypOpis
idstring (uuid)
eventIdstring (uuid)
eventTypestring
statusstring

Jedno z: pending, success, failed, cancelled

attemptsinteger
nextAttemptAtstring (date-time)może być null
lastAttemptAtstring (date-time)może być null
responseStatusintegermoże być null
responseExcerptstringmoże być null
errorstringmoże być null
durationMsintegermoże być null
manualboolean
createdAtstring (date-time)
ObiektyDelivery
{
  "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

Atrybuty

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

Jedno z: 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
wymagane
string

Jedno z: 2026-10-01

createdAt
wymagane
string (date-time)
workspaceId
wymagane
string (uuid)
projectIdstring (uuid)może być null
actorobjectmoże być nullWho made the change (null for system changes).
Pokaż pola actor
PoleTypOpis
idstring (uuid)
namestringmoże być null
data
wymagane
object
ObiektyEvent
{
  "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.

Atrybuty

PoleTypOpis
idstring (uuid)
workspaceIdstring (uuid)
keystring
namestring
descriptionstringmoże być null
startDatestring (date)
deadlinestring (date)może być null
currencystring
scheduleFromstring

Jedno z: forward, backward

colorstringmoże być null
archivedboolean
createdAtstring (date-time)
updatedAtstring (date-time)
urlstring (uri)
ObiektyProject (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

Klucz z prawem odczytu

Parametry zapytania

PoleTypOpis
workspaceIdstring (uuid)
projectIdstring (uuid)

Zwraca

200 OK Subscriptions

PoleTypOpis
webhooksarray of Webhook
Żądanie
curl https://planitude.app/api/webhooks \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź200 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

Klucz z prawem zapisu

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.

Treść żądania

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

Jedno z: 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)

Zwraca

201 Created Created

PoleTypOpis
webhookWebhook
secretstringwhsec_...
Żądanie
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"
}'
Odpowiedź201 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

Publiczne, bez klucza

Zwraca

200 OK Events

PoleTypOpis
apiVersionstring
eventsarray of string
Żądanie
curl https://planitude.app/api/webhooks/events
Odpowiedź200 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}

Klucz z prawem odczytu

Parametry ścieżki

PoleTypOpis
webhookId
wymagane
string (uuid)Webhook id.

Zwraca

200 OK Subscription

PoleTypOpis
webhookWebhook
Żądanie
curl https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88 \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź200 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}

Klucz z prawem zapisu

Parametry ścieżki

PoleTypOpis
webhookId
wymagane
string (uuid)Webhook id.

Treść żądania

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

Zwraca

200 OK Updated

PoleTypOpis
webhookWebhook
Żądanie
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}'
Odpowiedź200 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}

Klucz z prawem zapisu

Parametry ścieżki

PoleTypOpis
webhookId
wymagane
string (uuid)Webhook id.

Zwraca

204 No Content Deleted

Żądanie
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

Klucz z prawem odczytu

Parametry ścieżki

PoleTypOpis
webhookId
wymagane
string (uuid)Webhook id.

Parametry zapytania

PoleTypOpis
limitinteger1-100.

Domyślnie: 50

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

Zwraca

200 OK Deliveries

PoleTypOpis
deliveriesarray of Delivery
nextCursorstringmoże być null
Żądanie
curl https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/deliveries \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź200 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}

Klucz z prawem odczytu

Parametry ścieżki

PoleTypOpis
webhookId
wymagane
string (uuid)Webhook id.
deliveryId
wymagane
string (uuid)

Zwraca

200 OK Payload

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

Klucz z prawem zapisu

Parametry ścieżki

PoleTypOpis
webhookId
wymagane
string (uuid)Webhook id.
deliveryId
wymagane
string (uuid)

Zwraca

202 Accepted Queued

PoleTypOpis
deliveryDelivery
Żądanie
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"
Odpowiedź202 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

Klucz z prawem zapisu

Parametry ścieżki

PoleTypOpis
webhookId
wymagane
string (uuid)Webhook id.

Zwraca

202 Accepted Queued

PoleTypOpis
deliveryDelivery
Żądanie
curl -X POST https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/test \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź202 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

Klucz z prawem zapisu

Parametry ścieżki

PoleTypOpis
webhookId
wymagane
string (uuid)Webhook id.

Zwraca

200 OK New secret (shown once)

PoleTypOpis
webhookWebhook
secretstring
Żądanie
curl -X POST https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/rotate-secret \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź200 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"
}

Webhooki

Webhooki

Webhooki wysyłają POST HTTPS z treścią JSON do Twojego endpointu, gdy tylko coś się zmieni, niezależnie od tego, czy zmiana pochodzi z aplikacji webowej, API, serwera MCP czy importu. Webhook obejmuje jeden projekt albo wszystkie projekty workspace (właściciele i administratorzy).

Twórz je w Profil → Webhooki lub przez API, jako REST hooks: subskrypcja przez POST /api/webhooks, rezygnacja przez DELETE. Sekret podpisu jest pokazywany tylko raz.

Każde żądanie zawiera te nagłówki:

NagłówekOpis
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
Żądanie
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"
}'
Odpowiedź201 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"
}

Typy zdarzeń

Subskrybuj pojedyncze zdarzenia albo *, aby otrzymywać wszystkie. Każde zdarzenie ma tę samą kopertę; data zależy od typu.

ZdarzenieOpis
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.
Przykładowy 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"
  }
}

Weryfikacja podpisów

Każde żądanie jest podpisane HMAC-SHA256 i sekretem Twojego webhooka. Nagłówek Planitude-Signature zawiera znacznik czasu t i podpis v1, obliczony z t, kropki i surowej treści.

  1. Użyj surowej treści, przed jakimkolwiek parsowaniem JSON: ponownie zserializowana treść ma inny podpis.
  2. Oblicz HMAC i porównaj go w stałym czasie.
  3. Odrzucaj żądania, których znacznik czasu różni się od Twojego zegara o więcej niż 5 minut: przechwyconego żądania nie da się odtworzyć.
  4. Wymieniaj sekret, kiedy chcesz: stary od razu przestaje działać.
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
// });

Ponowienia i dostarczanie

Odpowiedz dowolnym 2xx w ciągu 10 sekund, a właściwą pracę wykonaj później, w kolejce. Przekierowania nie są śledzone. Przy błędach i przekroczeniu czasu Planitude próbuje łącznie do 6 razy: od razu, potem po 1 min, 5 min, 30 min, 2 h, 12 h.

Dostarczanie odbywa się co najmniej raz i bez gwarancji kolejności. Zapisuj id zdarzenia (Planitude-Event-Id, także id w treści) i pomijaj już przetworzone; sortuj po createdAt.

Po 5 zdarzeniach z rzędu, które zawiodły przy każdej próbie, webhook zostaje wyłączony, a właściciel dostaje e-mail. Odpowiedź 410 Gone wyłącza go od razu. Włącz go ponownie w profilu albo przez PATCH z active: true.

Dziennik dostarczeń (status, kod HTTP, fragment odpowiedzi, payload, ręczne ponowne wysłanie) jest przechowywany przez 30 dni. Jako cel akceptowane są tylko adresy publiczne.

Harmonogram ponowień6 × POST
Próba 1   od razu
Próba 2   + 1 min
Próba 3   + 5 min
Próba 4   + 30 min
Próba 5   + 2 h
Próba 6   + 12 h

Testowanie endpointu

  1. Wyślij zdarzenie webhook.ping testowym endpointem albo przyciskiem Testuj w profilu.
  2. Aby odbierać zdarzenia na swoim komputerze, udostępnij lokalny serwer tunelem (np. ngrok lub Cloudflare Tunnel) i zasubskrybuj jego publiczny adres HTTPS.
  3. Otwórz dziennik dostarczeń, aby zobaczyć status, kod HTTP i odpowiedź, i wyślij dostarczenie ponownie po poprawieniu endpointu.
Żądanie
curl -X POST https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/test \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Odpowiedź202 Accepted
{
  "delivery": {
    "id": "4b207161-80f9-40bb-bc3f-d8f70315be00",
    "eventId": "6f1c1d1e-2f4b-4d0a-9a77-2a3c5b1e9f10",
    "eventType": "task.completed",
    "status": "success",
    "attempts": 1,
    "nextAttemptAt": null,
    "lastAttemptAt": "2026-10-01T08:30:12.418Z",
    "responseStatus": 200,
    "responseExcerpt": "{\"ok\":true}",
    "error": null,
    "durationMs": 39,
    "manual": false,
    "createdAt": "2026-10-01T08:30:12.418Z"
  }
}

AI i MCP

Serwer MCP

Planitude jest serwerem MCP (Model Context Protocol): asystenci AI i edytory kodu czytają projekty, analizują ścieżkę krytyczną i obciążenie, tworzą i zmieniają zadania, z Twoimi uprawnieniami. Aplikacje webowe łączą się przez OAuth (logujesz się i zezwalasz na dostęp); narzędzia wiersza poleceń i edytory używają klucza API.

URL serwera

https://planitude.app/mcp

  • ChatGPTOAuth

    W ChatGPT otwórz Ustawienia › Bezpieczeństwo i logowanie i włącz tryb dewelopera. Utwórz aplikację z URL serwera i uwierzytelnianiem OAuth, potem zaloguj się do Planitude i zezwól na dostęp.

    Oficjalna dokumentacja ↗
  • ClaudeOAuth

    Otwórz Dostosuj › Konektory › Dodaj własny konektor, wklej URL serwera i wybierz Połącz: otworzy się Planitude, logujesz się i zezwalasz na dostęp. Działa w claude.ai, Claude Desktop i aplikacji mobilnej.

    Oficjalna dokumentacja ↗
  • GeminiOAuth

    Na gemini.google.com otwórz Ustawienia › Połączone aplikacje, wybierz Dodaj własną aplikację i wklej URL serwera; potem zaloguj się do Planitude i zezwól na dostęp.

    Oficjalna dokumentacja ↗
  • Claude CodeKlucz API

    Uruchom polecenie z kluczem w zmiennej środowiskowej. Dodaj --scope user, aby używać go we wszystkich projektach, i sprawdź przez claude mcp list.

    Oficjalna dokumentacja ↗
  • CodexKlucz API

    Umieść klucz w PLANITUDE_API_KEY i dodaj blok do ~/.codex/config.toml: działa w CLI, aplikacji i rozszerzeniu IDE.

    Oficjalna dokumentacja ↗
  • CursorKlucz API

    Dodaj blok do ~/.cursor/mcp.json (wszystkie projekty) lub .cursor/mcp.json (jeden projekt); Cursor czyta klucz ze środowiska.

    Oficjalna dokumentacja ↗
  • Dodaj .vscode/mcp.json do workspace: VS Code raz poprosi o klucz i bezpiecznie go zapisze, poza plikiem.

    Oficjalna dokumentacja ↗
  • Gemini CLIKlucz API

    Uruchom polecenie z kluczem w zmiennej środowiskowej albo dodaj blok do ~/.gemini/settings.json.

    Oficjalna dokumentacja ↗

Narzędzia

Serwer udostępnia 29 narzędzi, od odczytu i analizy po bezpieczne zmiany. Żadne nie usuwa projektów ani zadań.

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

Agenci AI

Dodaj do workspace’u jako członków do 5 zewnętrznych agentów AI: Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot lub dowolnego klienta MCP. Przydzielaj im zadania, wspominaj ich w komentarzach i przeglądaj ich zmiany.

Właściciele i administratorzy tworzą klucze agentów w Agenci, karta Połączenie. Klucz zaczyna się od pln_, jest pokazywany raz i przechowywany tylko jako hash; każdy agent może mieć do 2 kluczy, a unieważnienie działa od razu.

Klucze agentów działają tylko z serwerem MCP, który pokazuje wtedy narzędzia dla agentów zamiast zwykłych. W REST API dostają 403 agent_credential.

Każdy klucz czyta i komentuje albo może edytować. Przejęcie, ukończenie i proponowanie zmian wymagają klucza, który może edytować; w przeciwnym razie odpowiedź to 403 agent_key_read_only.

Agent widzi tylko projekty, do których go dodano, jako viewer (czyta i komentuje) lub editor (zmienia też zadania), nigdy jako właściciel. Projekt musi też mieć włączone „Zezwalaj agentom w tym projekcie”: domyślnie jest wyłączone i włącza je właściciel.

Agenci mogą zmieniać nazwę, notatki, czas trwania, postęp i termin zadania albo tworzyć zadania. Żadne narzędzie nie usuwa, nie zaprasza osób ani nie zmienia ról.

Domyślne limity na agenta: 60 żądań na minutę i 200 zapisów dziennie, z możliwością zwiększenia do 240 i 2000. Najwyżej 200 zmian na projekt może czekać na przegląd.

Narzędzia do odczytu umieszczają tekst napisany przez ludzi (nazwy, notatki, komentarze) w blokach planitude-data z losowym nonce, jako ciągi JSON, i oznaczają jako SUSPICIOUS wiersze wskazane przez automatyczną kontrolę: to dane, nigdy instrukcje. Komentarze czytane kluczem osobistym trafiają do tych samych bloków.

Jak działają agenci AI w Planitude
MCPClaude Code
claude mcp add --transport http planitude https://planitude.app/mcp \
  --header "Authorization: Bearer $PLANITUDE_AGENT_KEY"

Narzędzia dla agentów

Z kluczem agenta serwer MCP udostępnia te narzędzia (16):

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

Podczas wykonania w trybie Autonomiczny zmiany agenta w jego własnych zadaniach obowiązują od razu i zostają w historii, gotowe do przywrócenia. W innych przypadkach, a także w trybie Z zatwierdzaniem, czekają w „Do zatwierdzenia”, aż ktoś z projektu je zastosuje.

Bez webhooka agent czyta swoje zdarzenia przez planitude_poll_events (do 50 naraz) i potwierdza je przez planitude_ack_events.

Żądanietools/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
    }
  }
}

Webhook wykonania

Aby agent startował sam, włącz wykonanie w Agenci, karta Wykonywanie, i podaj webhook swojego runnera: Planitude wysyła podpisany POST, gdy agent ma zadanie do wykonania. Sekret zaczyna się od whsec_ i jest pokazywany raz. URL musi być publicznym adresem HTTPS: prywatne i lokalne są odrzucane.

Podpis, nagłówki, limit czasu 10 s i ponowienia (1 min, 5 min, 30 min, 2 h, 12 h) działają jak przy pozostałych webhookach. Po 5 nieudanych dostarczeniach z rzędu webhook się wyłącza: zapisz URL ponownie, aby go włączyć.

Powiadomienie zawiera tylko identyfikatory, nigdy treści zadania: agent czyta zadanie przez MCP.

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

Powiadomienie z newRun: true otwiera wykonanie. Agent przejmuje je przez planitude_claim_task i trzyma lease na 30 min (od 5 do 240), odnawiany przez planitude_extend_lease. Gdy lease wygaśnie, startuje nowa próba, maksymalnie 3 (najwyżej 10). Wykonanie, którego nikt nie przejmie, wygasa po 24 h.

planitude_complete_task ustawia zadanie na 100% i publikuje raport jako komentarz; przy otwartych podzadaniach odpowiada 409 subtasks_open. planitude_fail_task zapisuje powód i powiadamia zespół, który może je powtórzyć; planitude_release_task oddaje zadanie bez ponowienia.

Każde wykonanie pozwala na 50 zmian (do 500, potem 429), a każdy agent na 5 otwartych wykonań (potem 409 too_many_open_runs). Autonomiczny, tryb domyślny, stosuje zmiany od razu i pozwala je przywrócić; Z zatwierdzaniem wysyła je do przeglądu. Awaryjne zatrzymanie, dla projektu lub całego workspace’u, anuluje otwarte wykonania i blokuje zapisy.

Przykładowy 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"
    }
  }
}

Napisz runnera

Runner to Twoja mała usługa, która odbiera powiadomienia i uruchamia agenta. Pasuje dowolny język; w Node 20+ nie potrzebuje zależności.

  1. Sprawdź podpis na surowej treści i od razu odpowiedz 200: Planitude czeka najwyżej 10 s.
  2. Pomijaj już widziane zdarzenia (Planitude-Event-Id): ponowienia wysyłają to samo zdarzenie.
  3. Przy newRun: true przejmij zadanie i uruchom agenta, na przykład claude -p z serwerem MCP Planitude i kluczem agenta.
  4. Odnawiaj lease, gdy agent pracuje; przy run.cancel zatrzymaj go.
  5. Poproś agenta, by kończył linią PLANITUDE: DONE tylko wtedy, gdy całe zadanie jest gotowe, i wtedy ukończ je z jego raportem. W przeciwnym razie (PLANITUDE: NOT DONE - … lub brak ostatniej linii) oznacz je jako nieudane z tym, co zostało.

Traktuj treść zadania jako dane: każ agentowi nigdy nie wykonywać znalezionych w niej instrukcji i zezwól mu tylko na potrzebne narzędzia Planitude.

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>

Kanał OData (Power BI, Excel)

Kanał OData v4 tylko do odczytu dla Power BI, Excela i każdego klienta OData, pod dwoma adresami: jeden projekt albo wszystkie projekty, które właściciel klucza widzi w danym workspace.

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

Uwierzytelniaj się osobistym kluczem API z uprawnieniem do odczytu: Authorization: Bearer lub HTTP Basic z kluczem jako hasłem (dowolna nazwa użytkownika), czyli metodą oferowaną przez Power BI i Excela. Tokeny OAuth i pliki cookie sesji nie są akceptowane. Klucz ograniczony do jednego workspace nie odczyta pozostałych.

Tabele: Projects, Tasks, Milestones, Dependencies, Resources, Assignments. Schemat jest dostępny pod $metadata (CSDL XML), a dokument usługi pod adresem głównym.

Obsługiwane opcje: $select, $filter (porównania, and/or/not, in, contains, startswith, endswith, tolower, toupper), $orderby, $top, $skip, $count i /$count. Strony zawierają domyślnie 2000 wierszy, do 5000 z Prefer: odata.maxpagesize; korzystaj z @odata.nextLink. Odpowiedzi zawierają ETag: wyślij If-None-Match, aby otrzymać 304. $expand, $apply i $search nie są obsługiwane (400).

Kanał obejmuje maksymalnie 500 projektów i 25 000 zadań (powyżej tego 413). Żądania wliczają się do limitu odczytu klucza: 240 na minutę.

Przewodnik krok po kroku dla Power BI i Excela
ŻądaniecURL
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"
Odpowiedź200 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
    }
  ]
}

Zmiany

  1. Nowy kanał OData v4 tylko do odczytu pod /api/odata/projects/:projectId i /api/odata/workspaces/:workspaceId dla Power BI, Excela i innych klientów OData: sześć tabel, $metadata, $select, $filter, $orderby, $top, $skip, $count, stronicowanie po stronie serwera i ETag.

  2. Nowy endpoint GET /api/projects/:projectId/export: plan jako XML Microsoft Project, CSV, obraz PNG lub PDF, z opcjami skali, zakresu dat, ścieżki krytycznej, planu bazowego, zależności, formatu papieru i orientacji.

  3. Wszystkie klucze API zaczynają się teraz od pln_. Klucze zaczynające się od gnt_ już nie działają: utwórz nowy.

  4. Agenci wykonują zadania: podpisany webhook wykonania (task.assigned, task.start_due, task.due_today, task.overdue, run.retry, run.cancel), 6 narzędzi wykonania z lease i przewodnik po pisaniu runnera.

  5. Narzędzia MCP do odczytu opakowują tekst napisany przez ludzi w bloki planitude-data z nonce, jako ciągi JSON z oznaczeniem SUSPICIOUS, dla każdego rodzaju klucza.

  6. Agenci AI jako członkowie workspace’u: klucze agentów działające tylko z serwerem MCP, 10 narzędzi do czytania, komentowania i proponowania zmian oraz kolejka zdarzeń.

  7. Nowa dokumentacja dla programistów, generowana z dokumentu OpenAPI. Dokument OpenAPI opisuje teraz wszystkie pola zwracane dla członków, komentarzy, planów bazowych, szablonów i przypisań.

  8. Wersja API 2026-10-01: podpisane webhooki wychodzące, udokumentowane publiczne API REST (OpenAPI 3.1), paginacja kursorem i wyszukiwanie po externalId.

  9. OAuth 2.1 dla serwera MCP i API: ChatGPT, Claude i Gemini łączą się bez kopiowania klucza.

  10. Serwer MCP i osobiste klucze API z prawem odczytu lub odczytu i zapisu.

Reklamy pozwalają utrzymać bezpłatny dostęp do Planitude