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.

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.

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's name and color.

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 the relative path to use in markdown (e.g. ![alt](.attachments.{pageId}/filename.png)).

Delete an attachment from a page.

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.