Verify connectivity to the configured Nextcloud instance and report how many collectives are visible.

List all Collectives the authenticated user has access to. Returns id, name, slug, emoji, and permission levels.

Create a new Collective. Also creates the underlying Nextcloud Team. Optionally set an emoji icon.

Change a Collective's emoji or adjust edit/share permission levels. Provide the id and any fields to change. Note: collective renaming is not supported by the API.

Soft-delete a Collective (moves it to the Collectives trash, recoverable). Use permanently_delete_collective to remove it permanently and optionally delete the underlying Team.

List Collectives that have been soft-deleted. These can be restored or permanently deleted.

Restore a soft-deleted Collective from the trash.

Permanently delete a Collective from the trash. THIS IS IRREVERSIBLE. The Collective must already be in the trash (use delete_collective first). Set deleteTeam=true to also remove the underlying Nextcloud Team.

List all pages in a Collective. Returns flat metadata (id, title, parentId, emoji, tags, timestamps, paths). Use parentId to reconstruct the tree.

Fetch a page as markdown. Returns the metadata block followed by the page body.

Full-text search across all Collectives pages the user can access. Uses the Nextcloud unified search provider. For searching within a specific Collective, use search_in_collective instead.

Search for pages by content within a specific Collective. Returns matching page metadata.

Create a new page under a parent. If the parent is a leaf page, it is automatically promoted to a folder. Optionally initialise from a template.

Replace, append to, or prepend to a page's markdown body. Mode defaults to "replace".

Trash a page (recoverable from the Collectives page trash). Folder pages take their entire subtree with them. The Landing page cannot be deleted — delete the collective itself instead.

Rename a page within its current parent.

Move a page to a new parent within the same collective. If the new parent is a leaf, it is promoted first.

Move or copy a page (with its subpages and attachments) into a different Collective. Set copy: true to duplicate instead of moving. The page id changes on arrival, so use the returned page for follow-up calls. For reorganising within one Collective use move_page or copy_page instead.

Set the single-emoji icon on a page. Pass an empty string to clear.

Duplicate a page under the same parent. If newTitle is provided, the copy gets that title. Works for both leaf and folder pages.

Toggle a page's full-width layout. This is a Collective-wide display property of the page, not a per-user preference.

Set the explicit left-to-right ordering of a page's immediate child pages. Every id must be a direct child of the page; duplicates are rejected. Pass an empty array to clear the manual order and fall back to the Collective sort. Only takes effect for users whose page order is set to "byOrder".

Bump a page's modification timestamp and record the authenticated user as its last editor, without changing content. Useful for marking a page as reviewed.

Mark a page as a favorite for the authenticated user.

Remove a page from the authenticated user's favorites.

List all tags defined for a Collective.

Create a new tag in a Collective. Requires a name and a hex color code (e.g. "#FF0000").

Update a tag. Both name and color are always applied, so pass the existing value for whichever one you are not changing — omitting a field is not supported by the API. Read current values with list_tags first.

Delete a tag from a Collective.

Replace the tags on a page. Tags must already exist in the Collective; pass tag ids (use list_tags to look them up).

List pages in the trash for a Collective. These can be restored or permanently purged.

Restore a trashed page back to its original location.

Permanently delete a trashed page. THIS IS IRREVERSIBLE — the page content cannot be recovered after this call. The page must already be in the trash (use delete_page first).

List available versions (revision history) for a page. Returns version ids that can be used with restore_page_version.

Restore a specific historical version of a page. The current content is replaced with the selected version (the current version is preserved as a new version entry).

List recently-modified pages for a Collective, ordered by last edit time.

Find pages that link to the given page. Scans the linkedPageIds field on all pages in the Collective.

List attachments for a page. Returns name, size, content type, and the relative markdown path to reference each file.

Upload an attachment to a page. Creates the attachment directory if needed. Returns a percent-encoded relativePath ready to paste into markdown (e.g. ![alt](.attachments.{pageId}/filename.png)).

Delete an attachment from a page. Returns the deleted attachment including its id, which restore_attachment needs to undo this.

Download an attachment's contents. Returns the bytes as utf8 text or a base64 string, with the encoding stated in the result. Refuses files over 5 MB, which should be fetched from Nextcloud directly.

Rename an attachment on a page. Existing references to the old filename in page bodies are NOT rewritten — update them yourself, using the returned relativePath.

Restore a deleted attachment from the page's attachment trash. Takes the numeric attachment id — a trashed attachment no longer appears in list_attachments, so there is no name to look up. delete_attachment returns the id you need.

List page templates defined for a Collective.

Create a page template in a Collective.

Rename a page template.

Set or clear the emoji icon on a page template.

Delete a page template.

Read a page template's metadata and markdown body. Use this to inspect what create_page(templateId) will produce.

Write a page template's markdown body. This is the content create_page(templateId) copies into new pages. An empty body is allowed and clears the template. Append and prepend are protected against concurrent edits and fail rather than overwriting someone else's change.

List all public share links on a Collective, including per-page shares. Each entry reports its scope ("collective" or "page"), token, whether visitors can edit, and whether a password is set. Passwords themselves are never returned.

Create a public share link for an entire Collective. Anyone with the link can read it (and edit, if you later enable that with update_share). Returns the share token; build the URL as {nextcloud}/apps/collectives/p/{token}.

Create a public share link for a single page rather than the whole Collective. Returns the share token; build the URL as {nextcloud}/apps/collectives/p/{token}.

Update an existing share link. editable is required by the API and is always applied, so state it explicitly or you may silently change it. Pass pageId for a page share; omit it for the Collective-wide share. Pass an empty password to remove an existing one.

Revoke a public share link. The link stops working immediately for everyone holding it. Pass pageId for a page share; omit it for the Collective-wide share.

Set the default page mode for a Collective — whether pages open in view or edit mode. This applies to every member of the Collective, unlike set_user_settings which is per-user.

Update the authenticated user's own display preferences for one Collective: page sort order, and whether the members and recent-pages widgets on the landing page are expanded. These are per-user and do not affect other members — use set_page_mode for the Collective-wide setting. Provide at least one field; omitted fields are left unchanged.