Was passiert, wenn ich das Limit überschreite?

Anfragen über das Rate-Limit (120 pro Minute) hinaus erhalten HTTP 429 mit klarer Fehlermeldung. Monatliche Quotas werden zum Monatswechsel zurückgesetzt.

PathHub API — Projektpläne und KI per REST & Webhooks

Q: In welchen Tarifen ist die API enthalten?

API-Zugang ist Teil von Pro (2.000 Aufrufe pro Monat) und Max (20.000 Aufrufe). Der Free-Plan enthält keine API.

Q: Sind die Webhooks signiert?

Ja. Jedes Webhook-Delivery wird mit HMAC-SHA256 signiert. Der Header X-PathHub-Signature enthält Timestamp und Signatur, sodass du sicher prüfen kannst, dass der Request von PathHub stammt.

Was du mit der API machen kannst

PathHub-Logik ist nicht in der App eingesperrt. Die meisten In-App-Funktionen sind 1:1 als REST-Endpoint verfügbar – inklusive aller KI-Features.

KI-Projektpläne aus Beschreibungen erzeugen

POST mit Beschreibung in 1-2 Sätzen, raus kommt ein vollständiger ActionPath: Phasen, Aufgaben, Risiken, Budget, Compliance, Stakeholder.

Aufgaben programmatisch lesen & ändern

Listen, Sub-Ressourcen, PATCH auf einzelne Aufgaben. Status-Änderungen lösen Webhooks aus – ideal für Dashboards und Automationen.

Webhooks für Echtzeit-Events

Sieben Events (task.status_changed, project.created, risk.added …), HMAC-signiert, 3-fache Retry mit Backoff.

KI-Chat & Tools per API

RAG-Chat mit deinen Projektdokumenten, RACI/SWOT/Risikomatrizen/Gantt generieren, autonome Agenten starten – alles via einfacher POST-Calls.

Pläne nach Markdown exportieren

Vollständiger ActionPath als Markdown – perfekt um Pläne an ChatGPT/Claude zu füttern oder in Notion/Confluence zu pasten.

Compliance-Bibliothek programmatisch

DSGVO, NIS2, ISO 27001, Branchenregeln – alle DE/AT/CH-Vorschriften filterbar nach Land, Branche und Unternehmensgröße abfragen.

In 3 Schritten startklar

Vom „noch nie probiert" bis zum ersten erfolgreichen Aufruf in unter fünf Minuten.

1

Key erstellen

In der App unter Tools › Entwickler / API. Wähle Scope (read, write oder ai). Key wird genau einmal angezeigt – sicher speichern.

2

Anfrage senden

Header Authorization: Bearer phk_live_…. Basis-URL: https://app.pathhub.ai/api/v1. Antworten sind immer JSON oder Markdown.

3

Webhook abonnieren (optional)

POST auf /v1/webhooks mit deiner HTTPS-URL. PathHub signiert jedes Delivery mit HMAC-SHA256 – Verify-Snippet steht in der Doku.

Beispiele

Curl-Snippets für die häufigsten Use-Cases – ohne weitere Erklärung copy-paste-fähig.

Projektplan generieren

Aus einer 1-Satz-Beschreibung wird ein vollständiger ActionPath.

generate-plan.shcurl

curl -X POST https://app.pathhub.ai/api/v1/ai/generate-plan \
  -H "Authorization: Bearer phk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Internes Wiki einführen, ~15 MA, 6 Wochen.",
    "title": "Internes Wiki",
    "desired_timeline_weeks": 6
  }'

Aufgabe abhaken

Löst gleichzeitig einen Webhook task.status_changed aus.

patch-task.shcurl

curl -X PATCH \
  https://app.pathhub.ai/api/v1/tasks/<task_id> \
  -H "Authorization: Bearer phk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"checked": true}'

Webhook anlegen

Antwort liefert secret nur einmal – sofort speichern.

create-webhook.shcurl

curl -X POST https://app.pathhub.ai/api/v1/webhooks \
  -H "Authorization: Bearer phk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhook",
    "events": ["task.status_changed"]
  }'

Endpoint-Übersicht

19 Endpoints, gruppiert nach Funktion. Vollständige Beschreibungen inkl. Request/Response-Schemas in der interaktiven Referenz.

GET/v1/projects

GET/v1/projects/{id}

GET/v1/projects/{id}/{resource}

GET/v1/projects/{id}/export

PATCH/v1/tasks/{id}

GET/v1/documents

POST/v1/documents/search

GET/v1/webhooks

POST/v1/webhooks

DELETE/v1/webhooks/{id}

POST/v1/ai/generate-plan

POST/v1/ai/projects/{id}/chat

POST/v1/ai/projects/{id}/tools/{tool}

POST/v1/ai/projects/{id}/agents/{task}

POST/v1/ai/projects/{id}/recommendations

GET/v1/ai/agents

GET/v1/compliance-rules

GET/v1/project-templates

GET/v1/usage

Live ausprobieren: jeden Endpoint mit „Try it out"-Button testen.

Interaktive Referenz öffnen

Funktioniert mit jeder iPaaS-Plattform

Die REST-API + Webhooks sind generisch genug, dass alle gängigen No-Code-Tools sie ohne dedizierte App nutzen können.

Zapier

Make

n8n

Power Automate

Eigener Code (Node, Python, Go, …)

FAQ

Die häufigsten Fragen zu Tarifen, Limits und Sicherheit.

In welchen Tarifen ist die API enthalten?

API-Zugang ist Teil von Pro (2.000 Aufrufe/Monat) und Max (20.000 Aufrufe/Monat). Der Free-Plan enthält keine API. Enterprise-Quotas auf Anfrage.

Wie funktioniert die KI-Quota in Kombination mit der API?

KI-Aufrufe (Plan-Generierung, Chat, Tools, Agenten) zählen sowohl gegen das API-Request-Kontingent als auch gegen die geteilte KI-Quota des Arbeitsbereichs (50/Monat im Pro, 500/Monat im Max). Pure Lese-Aufrufe (Projekte, Aufgaben, Compliance) zählen nur gegen das API-Limit.

Brauche ich eigenen Code, um PathHub anzubinden?

Nein. Die REST-API ist mit Zapier, Make, n8n und Power Automate kompatibel. Eigener Code (Node, Python, Go etc.) ist nur nötig, wenn du tieferes Verhalten brauchst – z.B. Custom-Mappings auf interne Systeme.

Sind die Webhooks signiert?

Ja. Jedes Webhook-Delivery wird mit HMAC-SHA256 signiert. Der Header X-PathHub-Signature: t=<unix_ts>,v1=<mac> enthält Timestamp und Signatur. Fertiges Verify-Snippet in Node.js findest du in der ausführlichen Doku. Replay-Schutz: Deliveries älter als 5 Minuten ablehnen.

Was passiert, wenn ich das Rate-Limit überschreite?

Anfragen über 120/Minute hinaus erhalten HTTP 429 mit Code rate_limit_exceeded. Monatliche Quotas resetten zum Monatswechsel. Aktuelle Nutzung jederzeit per GET /v1/usage abrufbar.

Sind die API-Keys an einen Arbeitsbereich gebunden?

Ja. Jeder Key gehört zu genau einem Arbeitsbereich und sieht nur dessen Daten. Wenn du mehrere Arbeitsbereiche hast (z.B. mehrere Kunden), erstellst du pro Arbeitsbereich einen eigenen Key. Keys können jederzeit widerrufen werden.

Gibt es eine offizielle OpenAPI-Spec?

Ja, unter /api/v1/openapi liegt die vollständige OpenAPI-3.0-YAML. Direkt importierbar in Postman, Insomnia, Stoplight oder als Quelle für Code-Generatoren.

PathHub über REST ansprechen