Pages & Workspaces — API und MCP
Überblick
Dieser Bereich stellt 58 Operationen bereit. Jede davon ist zugleich ein MCP-Werkzeug.
Der Bereich hängt am Modul-Schalter module.pages. Ist das Modul aus, antworten diese Operationen mit 404.
Operationen
| Methode | Pfad | Zweck | Recht | Parameter |
|---|---|---|---|---|
GET | /api/v1/pages | Liste der Page | pages.page.view | page, workspace, parent, trashed, template, q |
POST | /api/v1/pages | Eine Page anlegen | pages.page.create | + Rumpf |
POST | /api/v1/pages/ask | Eine PagesAsk anlegen | pages.page.view | + Rumpf |
DELETE | /api/v1/pages/comments/{ulid} | Eine PageComment löschen | pages.page.view | ulid |
POST | /api/v1/pages/comments/{ulid}/resolve | Kommentar als erledigt markieren — Markiert den Kommentar als erledigt; der Thread bleibt lesbar. | pages.comment.resolve | ulid, + Rumpf |
GET | /api/v1/pages/databases | Liste der PagesDatabase | pages.page.view | page, workspace, q |
PATCH | /api/v1/pages/databases/{databaseUlid}/linked-rows/{ulid} | Zeile einer verknüpften Datenbank ändern — Schreibt geänderte Werte einer Zeile aus einer verknüpften Datenbank über die API der Quelle (z. B. Status einer Aufgabe, Phase eines Deals). Es gelten die Rechte, die Prüfungen und das Protokoll der Quelle; nur Spalten mit config.writable sind änderbar. Die Zeilen-ULID ist die ULID des Quell-Objekts. | pages.page.view | databaseUlid, ulid, + Rumpf |
GET | /api/v1/pages/databases/{ulid} | Eine PagesDatabase lesen | pages.page.view | ulid |
PATCH | /api/v1/pages/databases/{ulid} | Eine PagesDatabase ändern | pages.database.manage | ulid, + Rumpf |
POST | /api/v1/pages/databases/{ulid}/properties | Spalte der Datenbank-Seite anlegen — Legt eine Spalte an. Der Schlüssel wird aus dem Namen abgeleitet und ist danach unveränderlich. | pages.database.manage | ulid, + Rumpf |
POST | /api/v1/pages/databases/{ulid}/query | Zeilen nach Filter und Sortierung abfragen — Liefert die Zeilen nach der Filter- und Sortier-DSL. viewUlid übernimmt die Einstellungen der View, Angaben im Rumpf übersteuern sie. Reine Abfrage — es wird nichts geändert. | pages.page.view | ulid, + Rumpf |
POST | /api/v1/pages/databases/{ulid}/rows | Zeile anlegen — Legt eine Zeile in der Datenbank-Seite an, optional aus fromTemplateRowUlid vorbefüllt. | pages.page.view | ulid, + Rumpf |
POST | /api/v1/pages/databases/{ulid}/rows/import | CSV-Zeilen importieren — Importiert die Zeilen einer CSV in die Datenbank-Seite; mehr als 2000 Zeilen weist der Import ab (422). | pages.database.manage | ulid, + Rumpf |
POST | /api/v1/pages/databases/{ulid}/views | View anlegen — Legt eine View an. Eine geteilte View verlangt das Datenbank-Verwaltungsrecht, eine persönliche gehört dem Aufrufer. | pages.page.view | ulid, + Rumpf |
GET | /api/v1/pages/entity-ref-options | Liste der PagesEntityRefOption | pages.page.view | type, q |
GET | /api/v1/pages/entity-ref-targets | Liste der PagesEntityRefTarget | pages.page.view | — |
GET | /api/v1/pages/favorites | Liste der PageFavorite | pages.page.view | page |
POST | /api/v1/pages/favorites | Eine PageFavorite anlegen | pages.page.view | + Rumpf |
DELETE | /api/v1/pages/favorites/{ulid} | Eine PageFavorite löschen | pages.page.view | ulid |
PATCH | /api/v1/pages/favorites/{ulid} | Eine PageFavorite ändern | pages.page.view | ulid, + Rumpf |
POST | /api/v1/pages/import | Eine PagesImport anlegen | pages.page.create | + Rumpf |
GET | /api/v1/pages/linked-sources | Quellen für verknüpfte Datenbanken — Listet die Quellen (Vorgänge, Kunden, Deals, Projekte, Angebote, Verträge …), aus denen eine Datenbank-Seite ihre Zeilen beziehen kann — je Quelle die Spalten mit Typ, ob sie schreibbar sind und ob sie als Rollup-Wert taugen. readable sagt, ob der Aufrufer die Quelle lesen darf. | pages.page.view | — |
DELETE | /api/v1/pages/properties/{ulid} | Eine PagesProperty löschen | pages.database.manage | ulid |
PATCH | /api/v1/pages/properties/{ulid} | Eine PagesProperty ändern | pages.database.manage | ulid, + Rumpf |
POST | /api/v1/pages/properties/{ulid}/restore | Gelöschte Spalte wiederherstellen — Holt eine gelöschte Spalte samt ihren Werten zurück — bis 30 Tage nach dem Löschen. Danach 422. | pages.database.manage | ulid, + Rumpf |
GET | /api/v1/pages/public/{token} | Öffentlichen Seiten-Link lesen — Liefert eine öffentlich geteilte Seite ohne Anmeldung (statisches HTML ohne Live-Referenzen). Unbekannter, widerrufener oder abgelaufener Link: 404. Passwortgeschützter Link (52:K-091): ohne Nachweis 401; das Passwort steht URL-kodiert im Kopf X-Pages-Password (gedrosselt je Link und Adresse, falsch: 403, zu viele Versuche: 429) und liefert zusätzlich einen Zugangs-Beweis accessKey, den weitere Abrufe im Kopf X-Pages-Access mitsenden. | öffentlich | token |
GET | /api/v1/pages/role-options | Rollen zur Auswahl in Seiten-Freigaben — Kennung und Name aller Rollen, alphabetisch — die Auswahlliste, mit der ein Arbeitsbereich oder eine Seite für eine Rolle freigegeben wird. Ohne Rechte und Mitglieder der Rollen. Erreichbar für jeden, der Zugriffe pflegen darf: Bereichsverwaltung oder -anlage, Eigentümer eines Bereichs, Vollzugriff auf einen Bereich oder eine Seite. | Objektregel pages.access.maintain | — |
DELETE | /api/v1/pages/rows/{ulid} | Eine PagesRow löschen | pages.page.view | ulid |
GET | /api/v1/pages/rows/{ulid} | Eine PagesRow lesen | pages.page.view | ulid |
PATCH | /api/v1/pages/rows/{ulid} | Eine PagesRow ändern | pages.page.view | ulid, + Rumpf |
POST | /api/v1/pages/rows/{ulid}/reorder | Zeile neu einsortieren — Ordnet die Zeile innerhalb ihrer Sortierung neu ein. | pages.page.view | ulid, + Rumpf |
POST | /api/v1/pages/rows/{ulid}/restore | Restore row — Restore row. Dedicated action endpoint — not a standard CRUD create. | pages.page.view | ulid, + Rumpf |
GET | /api/v1/pages/versions/{ulid} | Eine PageVersion lesen | pages.page.view | ulid |
POST | /api/v1/pages/versions/{ulid}/restore | Restore version — Restore version. Dedicated action endpoint — not a standard CRUD create. | pages.page.update | ulid, + Rumpf |
DELETE | /api/v1/pages/views/{ulid} | Eine PagesView löschen | pages.page.view | ulid |
PATCH | /api/v1/pages/views/{ulid} | Eine PagesView ändern | pages.page.view | ulid, + Rumpf |
GET | /api/v1/pages/workspaces | Liste der PagesWorkspace | pages.workspace.view · pages.workspace.manage | page, q |
POST | /api/v1/pages/workspaces | Eine PagesWorkspace anlegen | pages.workspace.create | + Rumpf |
DELETE | /api/v1/pages/workspaces/{ulid} | Eine PagesWorkspace löschen | Objektregel pages.ws.manage | ulid |
GET | /api/v1/pages/workspaces/{ulid} | Eine PagesWorkspace lesen | Objektregel pages.ws.view | ulid |
PATCH | /api/v1/pages/workspaces/{ulid} | Eine PagesWorkspace ändern | Objektregel pages.ws.manage | ulid, + Rumpf |
DELETE | /api/v1/pages/{ulid} | Eine Page löschen | pages.page.delete · Objektregel pages.pg.delete | ulid |
GET | /api/v1/pages/{ulid} | Eine Page lesen | Objektregel pages.pg.view | ulid |
PATCH | /api/v1/pages/{ulid} | Eine Page ändern | pages.page.update · Objektregel pages.pg.edit | ulid, + Rumpf |
GET | /api/v1/pages/{ulid}/backlinks | Liste der PageBacklink | pages.page.view | ulid |
POST | /api/v1/pages/{ulid}/collab-token | Ticket für den Live-Editor ausgeben — Gibt ein Co-Editing-Ticket für den Live-Editor aus. Ohne konfigurierten Collab-Dienst: 409 feature_disabled. | Objektregel pages.pg.edit | ulid, + Rumpf |
GET | /api/v1/pages/{ulid}/comments | Liste der PageComment | pages.page.view | ulid, resolved |
POST | /api/v1/pages/{ulid}/comments | Kommentar an der Seite verfassen — Verfasst einen Kommentar an der Seite (Thread über parentUlid, Block-Anker über blockId, Textstelle über anchorId + anchorText — die Markierung commentAnchor mit derselben anchorId setzt der Editor in den Seiteninhalt). Erwähnte Nutzer (mentionedUserIds) werden benachrichtigt. | pages.comment.create | ulid, + Rumpf |
POST | /api/v1/pages/{ulid}/duplicate | Seite kopieren — Legt eine Kopie der Seite an. Verlangt Leserecht auf die Quellseite — sonst wäre eine verborgene Seite über ihre Kopie auslesbar. | pages.page.create · Objektregel pages.pg.view | ulid, + Rumpf |
GET | /api/v1/pages/{ulid}/export | Eine PageExport lesen | pages.page.view | ulid, format |
POST | /api/v1/pages/{ulid}/lock | Seite sperren — Sperrt die Seite gegen versehentliches Bearbeiten (52:K-090): Inhalt, Titel, Icon, Cover, Versions-Wiederherstellung sowie Zeilen, Eigenschaften und geteilte Ansichten einer Datenbank-Seite antworten mit 423, bis die Seite entsperrt wird. Kommentare bleiben möglich. Verlangt das Bearbeiten-Recht auf der Seite. | pages.page.update · Objektregel pages.pg.lock | ulid, + Rumpf |
POST | /api/v1/pages/{ulid}/move | Move page — Move page. Dedicated action endpoint — not a standard CRUD create. | pages.page.move · Objektregel pages.pg.edit | ulid, + Rumpf |
POST | /api/v1/pages/{ulid}/presence | Anwesenheit im Seiten-Editor melden — Meldet, dass der Aufrufer die Seite gerade bearbeitet (optional mit Block), und liefert die übrigen aktiven Bearbeiter sowie die aktuelle Inhalts-Revision. Ohne Schreibzugriff wird nur gelesen. | pages.page.view | ulid, + Rumpf |
POST | /api/v1/pages/{ulid}/restore | Restore page — Restore page. Dedicated action endpoint — not a standard CRUD create. | Objektregel pages.pg.edit | ulid, + Rumpf |
POST | /api/v1/pages/{ulid}/share | Seite öffentlich oder ins Portal teilen — Legt einen öffentlichen Link an, wechselt oder widerruft ihn bzw. setzt die Portal-Freigabe (shareAction). shareAction=password setzt, wechselt oder entfernt (publicPassword null) das Passwort des öffentlichen Links; gespeichert wird nur der Hash. Verlangt das Teilen-Recht UND Bearbeitungslevel auf der Seite. | pages.page.share · Objektregel pages.pg.edit | ulid, + Rumpf |
POST | /api/v1/pages/{ulid}/unlock | Seite entsperren — Hebt die Sperre der Seite auf (52:K-090). Entsperren darf nur, wer das Bearbeiten-Recht auf der Seite hat. | pages.page.update · Objektregel pages.pg.lock | ulid, + Rumpf |
GET | /api/v1/pages/{ulid}/versions | Liste der PageVersion | pages.page.view | ulid |
POST | /api/v1/pages/{ulid}/versions | Version der Seite schneiden — Schneidet eine benannte Version der Seite als Snapshot. Nie destruktiv — der aktuelle Inhalt bleibt unberührt. | pages.page.update | ulid, + Rumpf |
Zweckangaben, die nicht dem Standardmuster folgen, stammen unverändert aus der Schnittstellen-Beschreibung im Code.