Octibiz
Demo

Durchsucht Website und Dokumentation gemeinsam. Enter zeigt alle Treffer, Esc schließt.

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

MethodePfadZweckRechtParameter
GET/api/v1/pagesListe der Pagepages.page.viewpage, workspace, parent, trashed, template, q
POST/api/v1/pagesEine Page anlegenpages.page.create+ Rumpf
POST/api/v1/pages/askEine PagesAsk anlegenpages.page.view+ Rumpf
DELETE/api/v1/pages/comments/{ulid}Eine PageComment löschenpages.page.viewulid
POST/api/v1/pages/comments/{ulid}/resolveKommentar als erledigt markieren — Markiert den Kommentar als erledigt; der Thread bleibt lesbar.pages.comment.resolveulid, + Rumpf
GET/api/v1/pages/databasesListe der PagesDatabasepages.page.viewpage, 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.viewdatabaseUlid, ulid, + Rumpf
GET/api/v1/pages/databases/{ulid}Eine PagesDatabase lesenpages.page.viewulid
PATCH/api/v1/pages/databases/{ulid}Eine PagesDatabase ändernpages.database.manageulid, + Rumpf
POST/api/v1/pages/databases/{ulid}/propertiesSpalte der Datenbank-Seite anlegen — Legt eine Spalte an. Der Schlüssel wird aus dem Namen abgeleitet und ist danach unveränderlich.pages.database.manageulid, + Rumpf
POST/api/v1/pages/databases/{ulid}/queryZeilen 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.viewulid, + Rumpf
POST/api/v1/pages/databases/{ulid}/rowsZeile anlegen — Legt eine Zeile in der Datenbank-Seite an, optional aus fromTemplateRowUlid vorbefüllt.pages.page.viewulid, + Rumpf
POST/api/v1/pages/databases/{ulid}/rows/importCSV-Zeilen importieren — Importiert die Zeilen einer CSV in die Datenbank-Seite; mehr als 2000 Zeilen weist der Import ab (422).pages.database.manageulid, + Rumpf
POST/api/v1/pages/databases/{ulid}/viewsView anlegen — Legt eine View an. Eine geteilte View verlangt das Datenbank-Verwaltungsrecht, eine persönliche gehört dem Aufrufer.pages.page.viewulid, + Rumpf
GET/api/v1/pages/entity-ref-optionsListe der PagesEntityRefOptionpages.page.viewtype, q
GET/api/v1/pages/entity-ref-targetsListe der PagesEntityRefTargetpages.page.view—
GET/api/v1/pages/favoritesListe der PageFavoritepages.page.viewpage
POST/api/v1/pages/favoritesEine PageFavorite anlegenpages.page.view+ Rumpf
DELETE/api/v1/pages/favorites/{ulid}Eine PageFavorite löschenpages.page.viewulid
PATCH/api/v1/pages/favorites/{ulid}Eine PageFavorite ändernpages.page.viewulid, + Rumpf
POST/api/v1/pages/importEine PagesImport anlegenpages.page.create+ Rumpf
GET/api/v1/pages/linked-sourcesQuellen 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öschenpages.database.manageulid
PATCH/api/v1/pages/properties/{ulid}Eine PagesProperty ändernpages.database.manageulid, + Rumpf
POST/api/v1/pages/properties/{ulid}/restoreGelöschte Spalte wiederherstellen — Holt eine gelöschte Spalte samt ihren Werten zurück — bis 30 Tage nach dem Löschen. Danach 422.pages.database.manageulid, + 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.öffentlichtoken
GET/api/v1/pages/role-optionsRollen 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öschenpages.page.viewulid
GET/api/v1/pages/rows/{ulid}Eine PagesRow lesenpages.page.viewulid
PATCH/api/v1/pages/rows/{ulid}Eine PagesRow ändernpages.page.viewulid, + Rumpf
POST/api/v1/pages/rows/{ulid}/reorderZeile neu einsortieren — Ordnet die Zeile innerhalb ihrer Sortierung neu ein.pages.page.viewulid, + Rumpf
POST/api/v1/pages/rows/{ulid}/restoreRestore row — Restore row. Dedicated action endpoint — not a standard CRUD create.pages.page.viewulid, + Rumpf
GET/api/v1/pages/versions/{ulid}Eine PageVersion lesenpages.page.viewulid
POST/api/v1/pages/versions/{ulid}/restoreRestore version — Restore version. Dedicated action endpoint — not a standard CRUD create.pages.page.updateulid, + Rumpf
DELETE/api/v1/pages/views/{ulid}Eine PagesView löschenpages.page.viewulid
PATCH/api/v1/pages/views/{ulid}Eine PagesView ändernpages.page.viewulid, + Rumpf
GET/api/v1/pages/workspacesListe der PagesWorkspacepages.workspace.view · pages.workspace.managepage, q
POST/api/v1/pages/workspacesEine PagesWorkspace anlegenpages.workspace.create+ Rumpf
DELETE/api/v1/pages/workspaces/{ulid}Eine PagesWorkspace löschenObjektregel pages.ws.manageulid
GET/api/v1/pages/workspaces/{ulid}Eine PagesWorkspace lesenObjektregel pages.ws.viewulid
PATCH/api/v1/pages/workspaces/{ulid}Eine PagesWorkspace ändernObjektregel pages.ws.manageulid, + Rumpf
DELETE/api/v1/pages/{ulid}Eine Page löschenpages.page.delete · Objektregel pages.pg.deleteulid
GET/api/v1/pages/{ulid}Eine Page lesenObjektregel pages.pg.viewulid
PATCH/api/v1/pages/{ulid}Eine Page ändernpages.page.update · Objektregel pages.pg.editulid, + Rumpf
GET/api/v1/pages/{ulid}/backlinksListe der PageBacklinkpages.page.viewulid
POST/api/v1/pages/{ulid}/collab-tokenTicket 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.editulid, + Rumpf
GET/api/v1/pages/{ulid}/commentsListe der PageCommentpages.page.viewulid, resolved
POST/api/v1/pages/{ulid}/commentsKommentar 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.createulid, + Rumpf
POST/api/v1/pages/{ulid}/duplicateSeite 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.viewulid, + Rumpf
GET/api/v1/pages/{ulid}/exportEine PageExport lesenpages.page.viewulid, format
POST/api/v1/pages/{ulid}/lockSeite 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.lockulid, + Rumpf
POST/api/v1/pages/{ulid}/moveMove page — Move page. Dedicated action endpoint — not a standard CRUD create.pages.page.move · Objektregel pages.pg.editulid, + Rumpf
POST/api/v1/pages/{ulid}/presenceAnwesenheit 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.viewulid, + Rumpf
POST/api/v1/pages/{ulid}/restoreRestore page — Restore page. Dedicated action endpoint — not a standard CRUD create.Objektregel pages.pg.editulid, + Rumpf
POST/api/v1/pages/{ulid}/shareSeite ö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.editulid, + Rumpf
POST/api/v1/pages/{ulid}/unlockSeite 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.lockulid, + Rumpf
GET/api/v1/pages/{ulid}/versionsListe der PageVersionpages.page.viewulid
POST/api/v1/pages/{ulid}/versionsVersion der Seite schneiden — Schneidet eine benannte Version der Seite als Snapshot. Nie destruktiv — der aktuelle Inhalt bleibt unberührt.pages.page.updateulid, + Rumpf

Zweckangaben, die nicht dem Standardmuster folgen, stammen unverändert aus der Schnittstellen-Beschreibung im Code.

referenz.api-pages · Gilt ab Version 0.5.4