Desarrolladores

Construye con Planitude

Una API REST, webhooks firmados y un servidor MCP: mantén tus sistemas alineados con el plan, reacciona a cada cambio y deja que un asistente de IA trabaje en tus proyectos.

El código, los nombres de los campos y la referencia técnica están en inglés, como en la mayoría de las documentaciones de API.

URL base: https://planitude.app

Las solicitudes y respuestas son JSON sobre HTTPS. Duraciones y retrasos están en minutos laborables (una jornada de 8 horas son 480), los instantes en ISO 8601 UTC, las fechas sin hora en YYYY-MM-DD.

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

Inicio rápido

De cero a tu primer webhook en tres pasos. Solo necesitas una terminal.

  1. Crea una clave API

    Abre Perfil → Claves API, elige Lectura y escritura y copia la clave: empieza por pln_ y se muestra una sola vez. Guárdala en una variable de entorno.

  2. Haz tu primera llamada

    Lista los proyectos que ves. La clave actúa como tú: los mismos proyectos, los mismos roles.

  3. Recibe un webhook

    Suscribe un endpoint HTTPS público a los eventos que necesitas, envía enseguida un evento de prueba y verifica su firma.

1Terminal
export PLANITUDE_API_KEY="pln_…"
2
curl https://planitude.app/api/projects \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Resultado esperado200 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"
}'
Payload de ejemplowebhook.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"
      ]
    }
  }
}

Autenticación

Autentica cada solicitud con una clave API personal en la cabecera Authorization, como bearer token. Las claves son personales: actúan como tú, con tu rol en cada proyecto, nunca más. Puedes limitar una clave a un workspace, darle una caducidad y revocarla cuando quieras; cada llamada queda registrada junto a la clave.

Scopes

ScopePermite
readplanitude:readLeer proyectos, tareas, dependencias, miembros, comentarios, líneas base y webhooks.
writeplanitude:writeTodo lo de lectura, además de crear y modificar proyectos, tareas, dependencias, comentarios, líneas base y webhooks.

Las claves y las apps OAuth no pueden eliminar proyectos ni tareas: eliminar sigue en la app web, donde una persona lo confirma. Un script que apunta al id equivocado no puede borrar un plan.

OAuth 2.1 para apps de terceros

Las apps que actúan en nombre de otras personas usan OAuth 2.1: authorization code con PKCE (S256), refresh tokens rotados en cada uso, registro dinámico de clientes (RFC 7591). Pide el recurso https://planitude.app/api y el scope planitude:read o planitude:write.

Los endpoints se publican en los documentos de discovery estándar, así las librerías OAuth se configuran solas.

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

Buenas prácticas

  • Guarda las claves en variables de entorno o en un gestor de secretos, nunca en el código ni en un repositorio. Las claves empiezan por pln_ para que los escáneres de secretos las detecten.
  • Usa una clave de solo lectura cuando solo lees, y una clave por integración: puedes revocar una sin detener las demás.
  • Pon caducidad a las claves de los scripts y rótalas.
  • Llama a la API desde tu servidor, no desde el navegador: una clave en el código front-end es una clave pública.
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"
  ]
}

Errores

Planitude usa los códigos de estado HTTP estándar. Los errores tienen siempre la misma forma JSON: un código error estable para decidir y, cuando sirve, details con el motivo o los campos que corregir.

EstadoSignificado
400invalid_requestLa solicitud no es válida: details.fields lista cada campo con su problema.
401unauthorizedFalta la clave, no es válida, está revocada o caducada.
403forbiddenLa clave o tu rol no lo permiten (details.reason), por ejemplo una escritura con una clave de solo lectura, o una eliminación.
404not_foundNo encontrado, o no visible para ti.
409dependency_cycleConflicto con el plan, por ejemplo una dependencia que cerraría un ciclo (dependency_cycle).
429rate_limitedDemasiadas solicitudes: espera los segundos indicados en Retry-After.
500server_errorError por nuestra parte: reintenta con espera exponencial.

Error

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

Límites de frecuencia

Los límites se aplican por clave, en una ventana móvil de un minuto: 240 solicitudes de lectura y 60 de escritura. Por encima recibes 429 rate_limited con la cabecera Retry-After, en segundos.

Espera Retry-After antes de reintentar, reparte en el tiempo los trabajos masivos y agrupa muchos cambios en un change set: hasta 1000 cambios en una solicitud y un solo recálculo.

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

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

Paginación y búsqueda

Las listas de tareas se paginan con un cursor. Pasa limit (1–500, por defecto 100) y, para la página siguiente, el nextCursor de la respuesta anterior como cursor. Cuando nextCursor es null no hay más páginas.

Filtra con externalId (coincidencia exacta con tu identificador), q (el nombre contiene), updatedSince y completed; ordena con sort=-number (las más nuevas primero) o -updatedAt. Las listas más cortas, como proyectos, miembros y dependencias, llegan completas en una respuesta.

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

Versiones

La API y los payloads de los webhooks se versionan por fecha. La versión actual es 2026-10-01: es el campo apiVersion de cada evento y la info.version del documento OpenAPI.

Dentro de una versión solo añadimos: nuevos endpoints, nuevos campos opcionales, nuevos tipos de evento. Ningún campo se elimina ni cambia de tipo sin una nueva versión, así que ignora los campos que no conozcas.

Solicitud
curl https://planitude.app/api/webhooks/events
Respuesta200 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"
  ]
}

Referencia de la API

Account

Who is calling, and their workspaces.

User

Atributos

CampoTipoDescripción
idstring (uuid)
emailstring (email)
namestringpuede ser null
avatarUrlstringpuede ser null
localestring
emailVerifiedboolean
ObjetosUser
{
  "id": "b1666432-132a-4ea9-b1ae-76ea69e226c5",
  "email": "anna@example.com",
  "name": "Anna Rossi",
  "avatarUrl": null,
  "locale": "en",
  "emailVerified": true
}

Workspace

Atributos

CampoTipoDescripción
idstring (uuid)
namestring
rolestring

Uno de: owner, admin, member

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

Current user (connection test)

GET/api/auth/me

Clave con acceso de lectura

Devuelve

200 OK The user

CampoTipoDescripción
userUser
Solicitud
curl https://planitude.app/api/auth/me \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Respuesta200 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

Clave con acceso de lectura

Devuelve

200 OK Workspaces

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

Referencia de la API

Projects

Projects, templates and baselines.

Project

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

Atributos

CampoTipoDescripción
idstring (uuid)
workspaceIdstring (uuid)
keystringProject key, e.g. CRON (task keys are CRON-12).
keyLockedboolean
namestring
descriptionstringpuede ser null
startDatestring (date)
calendarIdstring (uuid)puede ser null
currencystring
scheduleFromstring

Uno de: forward, backward

deadlinestring (date)puede ser null
colorstringpuede ser null
settingsobject
archivedAtstring (date-time)puede ser null
createdBystring (uuid)puede ser null
createdAtstring (date-time)
updatedAtstring (date-time)
ObjetosProject
{
  "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

Atributos

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

Uno de: builtin, user

namestring
descriptionstringpuede ser null
taskCountinteger
durationDaysintegerWorking days from start to finish.
ObjetosTemplate
{
  "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

Atributos

CampoTipoDescripción
idstring (uuid)
namestring
indexintegerpuede ser nullNumbered MS Project baseline (1-10); null for the main baseline and the ones you name.
capturedAtstring (date-time)
capturedBystring (uuid)puede ser null
taskCountinteger
ObjetosBaseline
{
  "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

Clave con acceso de lectura

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

Parámetros de consulta

CampoTipoDescripción
archivedstring

Uno de: 1

Devuelve

200 OK Projects

CampoTipoDescripción
projectsarray of Project
Solicitud
curl https://planitude.app/api/projects \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Respuesta200 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

Clave con acceso de escritura

Cuerpo de la solicitud

CampoTipoDescripción
name
obligatorio
string
workspaceIdstring (uuid)Defaults to your personal workspace.
keystring2-5 letters/digits, starts with a letter. Derived from the name if omitted.
descriptionstringpuede ser null
startDatestring (date)
deadlinestring (date)puede ser null
currencystring
scheduleFromstring

Uno de: forward, backward

colorstringpuede ser null

Devuelve

201 Created Created

CampoTipoDescripción
projectProject
Solicitud
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"}'
Respuesta201 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

Clave con acceso de escritura

Cuerpo de la solicitud

CampoTipoDescripción
templateId
obligatorio
stringId from GET /api/templates.
startDate
obligatorio
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)

Devuelve

201 Created Created

CampoTipoDescripción
projectProject
taskCountinteger
conflictsarray of Conflict
Solicitud
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"
}'
Respuesta201 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

Clave con acceso de lectura

Parámetros de consulta

CampoTipoDescripción
localestring

Devuelve

200 OK Templates

CampoTipoDescripción
templatesarray of Template
Solicitud
curl https://planitude.app/api/templates \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Respuesta200 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}

Clave con acceso de lectura

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.

Devuelve

200 OK Project

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

Clave con acceso de escritura

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.

Cuerpo de la solicitud

CampoTipoDescripción
namestring
descriptionstringpuede ser null
startDatestring (date)
deadlinestring (date)puede ser null
currencystring
scheduleFromstring

Uno de: forward, backward

colorstringpuede ser null
archivedboolean

Devuelve

200 OK Updated

CampoTipoDescripción
projectProject
conflictsarray of Conflict
rescheduledbooleanThe schedule was recalculated (start date, calendar or direction changed).
Solicitud
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"}'
Respuesta200 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

Clave con acceso de lectura

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

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.

Parámetros de consulta

CampoTipoDescripción
formatstringFile format. mspdi = Microsoft Project XML.

Uno de: mspdi, csv, png, pdf

Por defecto: mspdi

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

Por defecto: en

scalestringPNG/PDF: time unit of the columns.

Uno de: auto, day, week, month, quarter

Por defecto: 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.

Uno de: 0, 1

Por defecto: 1

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

Uno de: 0, 1

Por defecto: 1

linksstringPNG/PDF: draw dependency arrows.

Uno de: 0, 1

Por defecto: 1

paperstringPDF: paper size.

Uno de: a4, a3, letter

Por defecto: a4

orientationstringPDF: page orientation.

Uno de: landscape, portrait

Por defecto: landscape

Devuelve

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

Solicitud
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

Clave con acceso de lectura

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.

Devuelve

200 OK Baselines

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

Clave con acceso de escritura

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.

Cuerpo de la solicitud

CampoTipoDescripción
namestring

Devuelve

201 Created Saved

CampoTipoDescripción
baselineBaseline
Solicitud
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"}'
Respuesta201 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
  }
}

Referencia de la 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.

Atributos

CampoTipoDescripción
idstring (uuid)
numberintegerSequential number in the project, never reused.
keystringHuman key, e.g. CRON-12.
parentIdstring (uuid)puede ser null
namestring
typestring

Uno de: summary, task, milestone

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

Uno de: 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)puede ser null
deadlinestring (date-time)puede ser null
calendarIdstring (uuid)puede ser null
costFixednumber
notesstringpuede ser null
colorstringpuede ser null
wbsstringpuede ser null
externalIdstringpuede ser nullYour identifier for this task in another system. Searchable with GET /tasks?externalId=.
startAtstring (date-time)puede ser nullComputed start.
finishAtstring (date-time)puede ser nullComputed finish.
isCriticalbooleanOn the critical path.
totalFloatMinintegerpuede ser nullTotal float (slack) in working minutes.
earlyStartAtstring (date-time)puede ser null
lateFinishAtstring (date-time)puede ser null
actualStartAtstring (date-time)puede ser null
actualFinishAtstring (date-time)puede ser null
actualDurationMinintegerpuede ser null
remainingDurationMinintegerpuede ser null
manuallyScheduledboolean
levelingDelayMininteger
taskTypestring

Uno de: fixed_units, fixed_duration, fixed_work, fixed_duration_and_units

effortDrivenboolean
durationOptimisticMinintegerpuede ser null
durationPessimisticMinintegerpuede ser null
projectIdstring (uuid)
completedbooleanprogressPct = 100.
assigneesarray of Assignee
urlstring (uri)Page of the task in the web app.
ObjetosTask
{
  "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

Atributos

CampoTipoDescripción
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
Mostrar los campos de stats
CampoTipoDescripción
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
ObjetosWriteResult
{
  "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

Atributos

CampoTipoDescripción
idstring (uuid)
taskIdstring (uuid)
userIdstring (uuid)
authorNamestring
authorAvatarUrlstringpuede ser null
bodystring
mentionsarray of string
createdAtstring (date-time)
editedAtstring (date-time)puede ser null
ObjetosComment
{
  "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

Clave con acceso de lectura

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.

Parámetros de consulta

CampoTipoDescripción
limitinteger1-500.

Por defecto: 100

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

Uno de: number, -number, -updatedAt

Por defecto: number

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

Uno de: true, false

Devuelve

200 OK A page of tasks

CampoTipoDescripción
tasksarray of Task
nextCursorstringpuede ser null
Solicitud
curl "https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/tasks?externalId=crm-4711" \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Respuesta200 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

Clave con acceso de escritura

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.

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.

Cuerpo de la solicitud

TaskCreate

CampoTipoDescripción
name
obligatorio
string
parentIdstring (uuid)puede ser nullParent (summary) task; null = top level.
afterTaskIdstring (uuid)puede ser nullInsert after this sibling.
beforeTaskIdstring (uuid)puede ser nullInsert before this sibling.
typestring

Uno de: summary, task, milestone

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

Uno de: 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)puede ser null
deadlinestring (date-time)puede ser null
calendarIdstring (uuid)puede ser null
costFixednumber
notesstringpuede ser null
colorstringpuede ser null
wbsstringpuede ser null
externalIdstringpuede ser nullYour identifier for this task in another system. Searchable with GET /tasks?externalId=.

o ChangeSet

CampoTipoDescripción
createTasksarray of TaskCreate
updateTasksarray of any
createDependenciesarray of DependencyCreate
deleteDependencyIdsarray of string
fullRescheduleboolean

Devuelve

201 Created Task created

CampoTipoDescripción
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
Mostrar los campos de stats
CampoTipoDescripción
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Solicitud
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"}'
Respuesta201 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}

Clave con acceso de lectura

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.
taskId
obligatorio
string (uuid)Task id.

Devuelve

200 OK The task

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

Clave con acceso de escritura

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

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.
taskId
obligatorio
string (uuid)Task id.

Cuerpo de la solicitud

CampoTipoDescripción
namestring
typestring

Uno de: summary, task, milestone

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

Uno de: 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)puede ser null
deadlinestring (date-time)puede ser null
calendarIdstring (uuid)puede ser null
costFixednumber
notesstringpuede ser null
colorstringpuede ser null
wbsstringpuede ser null
externalIdstringpuede ser nullYour identifier for this task in another system. Searchable with GET /tasks?externalId=.
placementobject
Mostrar los campos de placement
CampoTipoDescripción
parentIdstring (uuid)puede ser nullParent (summary) task; null = top level.
afterTaskIdstring (uuid)puede ser nullInsert after this sibling.
beforeTaskIdstring (uuid)puede ser nullInsert before this sibling.

Devuelve

200 OK Updated

CampoTipoDescripción
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
Mostrar los campos de stats
CampoTipoDescripción
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Solicitud
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}'
Respuesta200 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

Clave con acceso de lectura

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.
taskId
obligatorio
string (uuid)Task id.

Devuelve

200 OK Comments

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

Clave con acceso de escritura

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.
taskId
obligatorio
string (uuid)Task id.

Cuerpo de la solicitud

CampoTipoDescripción
body
obligatorio
stringPlain text.
mentionsarray of stringUser ids to notify.

Devuelve

201 Created Created

CampoTipoDescripción
commentComment
Solicitud
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."}'
Respuesta201 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
  }
}

Referencia de la API

Dependencies

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

Dependency

Atributos

CampoTipoDescripción
idstring (uuid)
predecessorIdstring (uuid)
successorIdstring (uuid)
typestring

Uno de: FS, SS, FF, SF

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

Clave con acceso de lectura

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.

Devuelve

200 OK Dependencies

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

Clave con acceso de escritura

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

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.

Cuerpo de la solicitud

DependencyCreate

CampoTipoDescripción
predecessorId
obligatorio
string (uuid)
successorId
obligatorio
string (uuid)
typestring

Uno de: FS, SS, FF, SF

Por defecto: FS

lagMininteger

Por defecto: 0

o dependencies

CampoTipoDescripción
dependencies
obligatorio
array of DependencyCreate

Devuelve

201 Created Created

CampoTipoDescripción
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
Mostrar los campos de stats
CampoTipoDescripción
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Solicitud
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
}'
Respuesta201 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}

Clave con acceso de escritura

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.
dependencyId
obligatorio
string (uuid)

Devuelve

200 OK Removed

CampoTipoDescripción
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
Mostrar los campos de stats
CampoTipoDescripción
taskCountinteger
recomputedCountintegerTasks the scheduling engine recalculated.
savedCountintegerTasks whose stored values changed.
durationMsinteger
Solicitud
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"
Respuesta200 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
  }
}

Referencia de la API

People

Project members and task assignees.

Member

Atributos

CampoTipoDescripción
userIdstring (uuid)
namestring
emailstring
rolestringEffective role on the project.

Uno de: owner, editor, viewer

directRolestringpuede ser nullRole granted on the project itself (null = only through the workspace).

Uno de: owner, editor, viewer

inheritedbooleanAccess comes from the workspace.
resourceIdstring (uuid)puede ser nullResource used when the person is assigned to tasks.
addedAtstring (date-time)
avatarUrlstringpuede ser null
ObjetosMember
{
  "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

Atributos

CampoTipoDescripción
resourceIdstring (uuid)
userIdstring (uuid)puede ser null
namestring
unitsPctinteger
ObjetosAssignee
{
  "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

Clave con acceso de escritura

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.

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.
taskId
obligatorio
string (uuid)Task id.

Cuerpo de la solicitud

CampoTipoDescripción
userIds
obligatorio
array of string
resourceIdsarray of string

Devuelve

200 OK Assignees saved

CampoTipoDescripción
taskIdstring (uuid)
assignmentsarray of object
Mostrar los campos de assignments
CampoTipoDescripción
idstring (uuid)
taskIdstring (uuid)
resourceIdstring (uuid)
unitsPctinteger
workMininteger
resourcesarray of object
Mostrar los campos de resources
CampoTipoDescripción
idstring (uuid)
userIdstring (uuid)puede ser null
namestring
kindstring

Uno de: work, material, cost

emailstringpuede ser null
costPerHournumber
costPerUsenumber
capacityPctinteger
calendarIdstring (uuid)puede ser null
colorstringpuede ser null
avatarUrlstringpuede ser null
needsRescheduleboolean
conflictsarray of Conflict
Solicitud
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"]}'
Respuesta200 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

Clave con acceso de lectura

Parámetros de ruta

CampoTipoDescripción
projectId
obligatorio
string (uuid)Project id.

Devuelve

200 OK Members

CampoTipoDescripción
membersarray of Member
rolestring
Solicitud
curl https://planitude.app/api/projects/40be00e0-7e34-4f7a-864b-5cc986f575b8/members \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Respuesta200 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"
}

Referencia de la API

Webhooks

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

Webhook

Atributos

CampoTipoDescripción
idstring (uuid)
workspaceIdstring (uuid)
workspaceNamestring
projectIdstring (uuid)puede ser nullnull = every project of the workspace.
projectNamestringpuede ser null
namestring
urlstring (uri)
eventsarray of string

Uno de: 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
disabledReasonstringpuede ser null

Uno de: failures, gone, project_deleted, user

disabledAtstring (date-time)puede ser null
consecutiveFailuresinteger
viaApibooleanCreated with the API (REST hook) rather than from the profile.
createdByobjectpuede ser null
Mostrar los campos de createdBy
CampoTipoDescripción
idstring (uuid)
namestringpuede ser null
createdAtstring (date-time)
updatedAtstring (date-time)
lastDeliveryAtstring (date-time)puede ser null
lastSuccessAtstring (date-time)puede ser null
ObjetosWebhook
{
  "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

Atributos

CampoTipoDescripción
idstring (uuid)
eventIdstring (uuid)
eventTypestring
statusstring

Uno de: pending, success, failed, cancelled

attemptsinteger
nextAttemptAtstring (date-time)puede ser null
lastAttemptAtstring (date-time)puede ser null
responseStatusintegerpuede ser null
responseExcerptstringpuede ser null
errorstringpuede ser null
durationMsintegerpuede ser null
manualboolean
createdAtstring (date-time)
ObjetosDelivery
{
  "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

Atributos

CampoTipoDescripción
id
obligatorio
string (uuid)Event id, also in the Planitude-Event-Id header: use it to deduplicate.
type
obligatorio
string

Uno de: 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
obligatorio
string

Uno de: 2026-10-01

createdAt
obligatorio
string (date-time)
workspaceId
obligatorio
string (uuid)
projectIdstring (uuid)puede ser null
actorobjectpuede ser nullWho made the change (null for system changes).
Mostrar los campos de actor
CampoTipoDescripción
idstring (uuid)
namestringpuede ser null
data
obligatorio
object
ObjetosEvent
{
  "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.

Atributos

CampoTipoDescripción
idstring (uuid)
workspaceIdstring (uuid)
keystring
namestring
descriptionstringpuede ser null
startDatestring (date)
deadlinestring (date)puede ser null
currencystring
scheduleFromstring

Uno de: forward, backward

colorstringpuede ser null
archivedboolean
createdAtstring (date-time)
updatedAtstring (date-time)
urlstring (uri)
ObjetosProject (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

Clave con acceso de lectura

Parámetros de consulta

CampoTipoDescripción
workspaceIdstring (uuid)
projectIdstring (uuid)

Devuelve

200 OK Subscriptions

CampoTipoDescripción
webhooksarray of Webhook
Solicitud
curl https://planitude.app/api/webhooks \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Respuesta200 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

Clave con acceso de escritura

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.

Cuerpo de la solicitud

CampoTipoDescripción
url
obligatorio
string (uri)HTTPS endpoint that receives the events. Public addresses only.
events
obligatorio
array of string* = all events.

Uno de: 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)

Devuelve

201 Created Created

CampoTipoDescripción
webhookWebhook
secretstringwhsec_...
Solicitud
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"
}'
Respuesta201 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

Público, sin clave

Devuelve

200 OK Events

CampoTipoDescripción
apiVersionstring
eventsarray of string
Solicitud
curl https://planitude.app/api/webhooks/events
Respuesta200 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}

Clave con acceso de lectura

Parámetros de ruta

CampoTipoDescripción
webhookId
obligatorio
string (uuid)Webhook id.

Devuelve

200 OK Subscription

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

Clave con acceso de escritura

Parámetros de ruta

CampoTipoDescripción
webhookId
obligatorio
string (uuid)Webhook id.

Cuerpo de la solicitud

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

Devuelve

200 OK Updated

CampoTipoDescripción
webhookWebhook
Solicitud
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}'
Respuesta200 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}

Clave con acceso de escritura

Parámetros de ruta

CampoTipoDescripción
webhookId
obligatorio
string (uuid)Webhook id.

Devuelve

204 No Content Deleted

Solicitud
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

Clave con acceso de lectura

Parámetros de ruta

CampoTipoDescripción
webhookId
obligatorio
string (uuid)Webhook id.

Parámetros de consulta

CampoTipoDescripción
limitinteger1-100.

Por defecto: 50

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

Devuelve

200 OK Deliveries

CampoTipoDescripción
deliveriesarray of Delivery
nextCursorstringpuede ser null
Solicitud
curl https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/deliveries \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Respuesta200 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}

Clave con acceso de lectura

Parámetros de ruta

CampoTipoDescripción
webhookId
obligatorio
string (uuid)Webhook id.
deliveryId
obligatorio
string (uuid)

Devuelve

200 OK Payload

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

Clave con acceso de escritura

Parámetros de ruta

CampoTipoDescripción
webhookId
obligatorio
string (uuid)Webhook id.
deliveryId
obligatorio
string (uuid)

Devuelve

202 Accepted Queued

CampoTipoDescripción
deliveryDelivery
Solicitud
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"
Respuesta202 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

Clave con acceso de escritura

Parámetros de ruta

CampoTipoDescripción
webhookId
obligatorio
string (uuid)Webhook id.

Devuelve

202 Accepted Queued

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

Clave con acceso de escritura

Parámetros de ruta

CampoTipoDescripción
webhookId
obligatorio
string (uuid)Webhook id.

Devuelve

200 OK New secret (shown once)

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

Webhooks

Webhooks

Los webhooks envían un POST HTTPS con un cuerpo JSON a tu endpoint en cuanto algo cambia, venga el cambio de la app web, de la API, del servidor MCP o de una importación. Un webhook cubre un proyecto, o todos los proyectos de un workspace (propietarios y administradores).

Créalos en Perfil → Webhooks o con la API, como REST hooks: suscripción con POST /api/webhooks, baja con DELETE. El secreto de firma se muestra una sola vez.

Cada solicitud lleva estas cabeceras:

CabeceraDescripción
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
Solicitud
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"
}'
Respuesta201 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"
}

Tipos de evento

Suscríbete a eventos concretos, o a * para recibirlos todos. Todos los eventos tienen el mismo sobre; data cambia según el tipo.

EventoDescripción
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.
Payload de ejemplo
{
  "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"
  }
}

Verificar firmas

Cada solicitud se firma con HMAC-SHA256 y el secreto de tu webhook. La cabecera Planitude-Signature contiene una marca de tiempo t y la firma v1, calculada sobre t, un punto y el cuerpo sin procesar.

  1. Usa el cuerpo sin procesar, antes de cualquier parseo JSON: un cuerpo reserializado tiene otra firma.
  2. Calcula el HMAC y compáralo en tiempo constante.
  3. Rechaza las solicitudes cuya marca de tiempo se aleje más de 5 minutos de tu reloj: una solicitud interceptada no se puede reproducir.
  4. Rota el secreto cuando quieras: el anterior deja de funcionar al instante.
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
// });

Reintentos y entrega

Responde con cualquier 2xx en menos de 10 segundos y haz el trabajo real después, en una cola. Las redirecciones no se siguen. Ante errores y tiempos de espera Planitude lo intenta hasta 6 veces en total: al momento y luego tras 1 min, 5 min, 30 min, 2 h, 12 h.

La entrega es al menos una vez y sin orden garantizado. Guarda el id del evento (Planitude-Event-Id, también id en el cuerpo) y omite los ya procesados; ordena por createdAt.

Tras 5 eventos seguidos fallidos en todos los intentos, el webhook se desactiva y su propietario recibe un correo. Una respuesta 410 Gone lo desactiva al instante. Reactívalo desde el perfil, o con PATCH y active: true.

El registro de entregas (estado, código HTTP, extracto de la respuesta, payload, reenvío manual) se conserva 30 días. Como destino solo se aceptan direcciones públicas.

Calendario de reintentos6 × POST
Intento 1   al momento
Intento 2   + 1 min
Intento 3   + 5 min
Intento 4   + 30 min
Intento 5   + 2 h
Intento 6   + 12 h

Prueba tu endpoint

  1. Envía un evento webhook.ping con el endpoint de prueba, o con el botón Probar del perfil.
  2. Para recibir eventos en tu ordenador, expón tu servidor local con un túnel (por ejemplo ngrok o Cloudflare Tunnel) y suscribe su dirección HTTPS pública.
  3. Abre el registro de entregas para ver estado, código HTTP y respuesta, y reenvía una entrega cuando hayas corregido el endpoint.
Solicitud
curl -X POST https://planitude.app/api/webhooks/1747ee7f-a395-4d3c-94b0-54b513d71d88/test \
  -H "Authorization: Bearer $PLANITUDE_API_KEY"
Respuesta202 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"
  }
}

IA y MCP

Servidor MCP

Planitude es un servidor MCP (Model Context Protocol): asistentes de IA y editores de código leen proyectos, analizan la ruta crítica y la carga de trabajo, y crean o modifican tareas, con tus permisos. Las apps web se conectan con OAuth (inicias sesión y permites el acceso); las herramientas de línea de comandos y los editores usan una clave API.

URL del servidor

https://planitude.app/mcp

  • ChatGPTOAuth

    En ChatGPT abre Configuración › Seguridad e inicio de sesión y activa el Modo desarrollador. Crea una app con la URL del servidor y autenticación OAuth, luego inicia sesión en Planitude y permite el acceso.

    Documentación oficial ↗
  • ClaudeOAuth

    Abre Personalizar › Conectores › Añadir conector personalizado, pega la URL del servidor y elige Conectar: se abre Planitude, inicias sesión y permites el acceso. Funciona en claude.ai, Claude Desktop y la app móvil.

    Documentación oficial ↗
  • GeminiOAuth

    En gemini.google.com abre Configuración › Apps conectadas, elige Añadir una app personalizada y pega la URL del servidor; luego inicia sesión en Planitude y permite el acceso.

    Documentación oficial ↗
  • Claude CodeClave API

    Ejecuta el comando con la clave en una variable de entorno. Añade --scope user para usarlo en todos los proyectos y compruébalo con claude mcp list.

    Documentación oficial ↗
  • CodexClave API

    Pon la clave en PLANITUDE_API_KEY y añade el bloque a ~/.codex/config.toml: vale para la CLI, la app y la extensión del IDE.

    Documentación oficial ↗
  • CursorClave API

    Añade el bloque a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto); Cursor lee la clave del entorno.

    Documentación oficial ↗
  • Añade .vscode/mcp.json al workspace: VS Code pide la clave una vez y la guarda de forma segura, fuera del archivo.

    Documentación oficial ↗
  • Gemini CLIClave API

    Ejecuta el comando con la clave en una variable de entorno, o añade el bloque a ~/.gemini/settings.json.

    Documentación oficial ↗

Herramientas

El servidor ofrece 29 herramientas, de la lectura y el análisis a los cambios seguros. Ninguna elimina proyectos ni tareas.

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

Agentes de IA

Añade hasta 5 agentes de IA externos al workspace como miembros: Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot o cualquier cliente MCP. Asígnales tareas, menciónalos en comentarios y revisa sus cambios.

Los owners y admins crean las claves de agente en Agentes, pestaña Conexión. La clave empieza por pln_, se muestra una sola vez y se guarda como hash; cada agente tiene hasta 2 claves y revocar una surte efecto al instante.

Las claves de agente solo funcionan con el servidor MCP, que muestra las herramientas para agentes en lugar de las habituales. En la API REST reciben 403 agent_credential.

Cada clave lee y comenta o puede editar. Tomar, completar y proponer cambios requiere una clave que pueda editar; si no, la respuesta es 403 agent_key_read_only.

Un agente solo ve los proyectos a los que se ha añadido, como viewer (lee y comenta) o editor (también cambia tareas), nunca como owner. El proyecto además necesita “Permitir agentes en este proyecto”: está desactivado por defecto y lo activa el owner.

Los agentes pueden cambiar el nombre, las notas, la duración, el avance y la fecha límite de una tarea, o crear tareas. Ninguna herramienta elimina, invita a personas ni cambia roles.

Límites por defecto por agente: 60 solicitudes por minuto y 200 escrituras al día, ajustables hasta 240 y 2000. Como máximo 200 cambios por proyecto pueden esperar revisión.

Las herramientas de lectura ponen el texto escrito por personas (nombres, notas, comentarios) en bloques planitude-data con un nonce aleatorio, como cadenas JSON, y marcan como SUSPICIOUS las filas señaladas por un control automático: son datos, nunca instrucciones. Los comentarios leídos con una clave personal llegan en los mismos bloques.

Cómo funcionan los agentes de IA en Planitude
MCPClaude Code
claude mcp add --transport http planitude https://planitude.app/mcp \
  --header "Authorization: Bearer $PLANITUDE_AGENT_KEY"

Herramientas para agentes

Con una clave de agente, el servidor MCP expone estas 16 herramientas:

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

Durante una ejecución Autónomo, los cambios del agente en sus propias tareas se aplican al instante y quedan en el historial, listos para restaurar. En los demás casos, y en modo Con aprobación, esperan en “Pendiente de revisión” hasta que alguien del proyecto los aplica.

Sin webhook, el agente lee sus eventos con planitude_poll_events (hasta 50 cada vez) y los confirma con planitude_ack_events.

Solicitudtools/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 de ejecución

Para que un agente arranque solo, activa la ejecución en Agentes, pestaña Ejecución, e introduce el webhook de tu runner: Planitude envía un POST firmado cuando el agente tiene una tarea que ejecutar. El secreto empieza por whsec_ y se muestra una sola vez. La URL debe ser una dirección HTTPS pública: se rechazan las privadas y locales.

La firma, las cabeceras, el tiempo de espera de 10 segundos y los reintentos (1 min, 5 min, 30 min, 2 h, 12 h) funcionan como en los demás webhooks. Tras 5 entregas fallidas seguidas el webhook se desactiva: vuelve a guardar la URL para reactivarlo.

El aviso solo lleva ids, nunca el texto de la tarea: el agente lee la tarea por MCP.

EventoDescripción
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.

Un aviso con newRun: true abre una ejecución. El agente la toma con planitude_claim_task y mantiene un lease de 30 minutos (de 5 a 240), renovado con planitude_extend_lease. Si el lease vence, empieza un nuevo intento, hasta 3 (como máximo 10). Una ejecución que nadie toma vence a las 24 horas.

planitude_complete_task lleva la tarea al 100 % y publica el informe como comentario; con subtareas abiertas responde 409 subtasks_open. planitude_fail_task registra el motivo y avisa al equipo, que puede relanzarla; planitude_release_task devuelve la tarea sin reintentos.

Cada ejecución permite 50 cambios (hasta 500, luego 429) y cada agente 5 ejecuciones abiertas (luego 409 too_many_open_runs). Autónomo, el modo por defecto, aplica los cambios al instante y permite restaurarlos; Con aprobación los envía a revisión. Una parada de emergencia, por proyecto o para todo el workspace, cancela las ejecuciones abiertas y bloquea las escrituras.

Payload de ejemplotask.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"
    }
  }
}

Escribir un runner

El runner es tu pequeño servicio que recibe los avisos y arranca el agente. Sirve cualquier lenguaje; con Node 20+ no necesita dependencias.

  1. Verifica la firma sobre el cuerpo sin procesar y responde 200 de inmediato: Planitude espera como máximo 10 segundos.
  2. Omite los eventos ya vistos (Planitude-Event-Id): los reintentos reenvían el mismo evento.
  3. Con newRun: true, toma la tarea y arranca el agente, por ejemplo claude -p con el servidor MCP de Planitude y la clave del agente.
  4. Renueva el lease mientras el agente trabaja; con run.cancel, detenlo.
  5. Pide al agente que termine con PLANITUDE: DONE solo si toda la tarea está hecha, y entonces completa con su informe. Si no (PLANITUDE: NOT DONE - … o sin línea final), márcala como fallida con lo que falta.

Trata el texto de la tarea como datos: pide al agente que nunca siga instrucciones que encuentre ahí y permítele solo las herramientas de Planitude que necesita.

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>

Fuente OData (Power BI, Excel)

Una fuente OData v4 de solo lectura para Power BI, Excel y cualquier cliente OData, en dos direcciones: un proyecto, o todos los proyectos que el titular de la clave ve en un espacio de trabajo.

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

Autenticación con una clave de API personal con acceso de lectura: Authorization: Bearer, o HTTP Basic con la clave como contraseña (cualquier nombre de usuario), que es el método que ofrecen Power BI y Excel. No se aceptan tokens OAuth ni cookies de sesión. Una clave limitada a un espacio de trabajo no puede leer los demás.

Tablas: Projects, Tasks, Milestones, Dependencies, Resources, Assignments. El esquema está en $metadata (CSDL XML) y el documento de servicio en la dirección raíz.

Opciones admitidas: $select, $filter (comparaciones, and/or/not, in, contains, startswith, endswith, tolower, toupper), $orderby, $top, $skip, $count y /$count. Las páginas contienen 2000 filas por defecto, hasta 5000 con Prefer: odata.maxpagesize; sigue @odata.nextLink. Las respuestas incluyen un ETag: envía If-None-Match para recibir 304. $expand, $apply y $search no se admiten (400).

Una fuente abarca como máximo 500 proyectos y 25.000 tareas (por encima, 413). Las solicitudes cuentan para el límite de lectura de la clave, 240 por minuto.

Guía paso a paso para Power BI y Excel
SolicitudcURL
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"
Respuesta200 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
    }
  ]
}

Novedades

  1. Nueva fuente OData v4 de solo lectura en /api/odata/projects/:projectId y /api/odata/workspaces/:workspaceId para Power BI, Excel y otros clientes OData: seis tablas, $metadata, $select, $filter, $orderby, $top, $skip, $count, paginación del lado del servidor y ETag.

  2. Nuevo endpoint GET /api/projects/:projectId/export: el plan en XML de Microsoft Project, CSV, imagen PNG o PDF, con opciones de escala, intervalo de fechas, ruta crítica, línea base, dependencias, tamaño de papel y orientación.

  3. Todas las claves API empiezan ahora por pln_. Las claves que empiezan por gnt_ ya no funcionan: crea una nueva.

  4. Los agentes ejecutan tareas: webhook de ejecución firmado (task.assigned, task.start_due, task.due_today, task.overdue, run.retry, run.cancel), 6 herramientas de ejecución con lease y una guía para escribir un runner.

  5. Las herramientas MCP de lectura envuelven el texto escrito por personas en bloques planitude-data con un nonce, como cadenas JSON con la marca SUSPICIOUS, para todo tipo de clave.

  6. Agentes de IA como miembros del workspace: claves de agente que solo funcionan con el servidor MCP, 10 herramientas para leer, comentar y proponer cambios, y una cola de eventos.

  7. Nueva documentación para desarrolladores, generada a partir del documento OpenAPI. El documento OpenAPI describe ahora todos los campos devueltos para miembros, comentarios, líneas base, plantillas y asignaciones.

  8. Versión de API 2026-10-01: webhooks salientes firmados, API REST pública documentada (OpenAPI 3.1), paginación con cursor y búsqueda por externalId.

  9. OAuth 2.1 para el servidor MCP y la API: ChatGPT, Claude y Gemini se conectan sin copiar una clave.

  10. Servidor MCP y claves API personales con acceso de lectura o de lectura y escritura.

La publicidad mantiene Planitude gratis