Mit der marble work REST-API steuerst du deine Organisation von außen: Kunden, Projekte und Aufgaben anlegen, Aufgabenketten aus KI- und Menschen-Schritten aufbauen, Agenten, Skills und Wissen pflegen und Ergebnisse abrufen. Typische Einsätze sind eigene Skripte, Automatisierungsplattformen und externe KI-Agenten.
<aside> 🚀 REST-API und MCP-Server setzen den Plan „Rocket“ voraus.
</aside>
<aside> 🤖
Du arbeitest mit einem KI-Agenten wie Claude Code, Cursor oder einem anderen MCP-Client? Dann ist der MCP-Server der bequemere Weg: dieselben Operationen als fertige Tools, ohne HTTP-Code. Siehe die Seite marble work » MCP-Server 🇩🇪
</aside>
Alle Aufrufe gehen an:
<https://api.marblework.app>
Es gibt nur die HTTP-Methoden GET (lesen) und POST (anlegen). Anfragen und Antworten sind JSON (Content-Type: application/json).
Aufgaben werden in der App gestartet. Über die API legst du Aufgaben samt Schrittkette an und liest Status und Ergebnisse aus; den Start eines Laufs löst ein Mensch in marble work aus. So behält dein Team die Kontrolle darüber, wann KI-Läufe Kosten verursachen.
curl -s <https://api.marblework.app/clients> \
-H "Authorization: Bearer mw_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Antwort:
{
"data": [
{
"id": "0b6d…",
"name": "Acme GmbH",
"slug": "acme-gmbh",
"email": "[email protected]",
"phone": null,
"website": "<https://acme.de>",
"contact_person": "Lisa Beispiel",
"created_at": "2026-08-01T09:12:00+00:00"
}
]
}
API-Keys erstellt ein Organisations-Admin in der App unter Einstellungen → Organisation → API-Zugriff. Beim Erstellen wählst du die Scopes (siehe unten). Der Key wird nur ein einziges Mal im Klartext angezeigt, danach ist er nicht mehr abrufbar. Bewahre ihn sicher auf, zum Beispiel in einem Passwort-Manager oder Secret-Store.
Ein Key gehört immer genau einer Organisation. Welche Organisation ein Aufruf betrifft, ergibt sich ausschließlich aus dem Key, es gibt keinen Organisations-Parameter.