1. Docs
2. /
3. Tool reference
4. /
5. Pages & Spaces

Pages & Spaces

Rich documents and the Spaces holding them: create, read, edit, restructure, tag, and publish.

51 verbs in this family.

• addOraEntry write Record an autonomous report in the person's daily Ora tab.
• appendPageContent write Append content to the end of an existing Page without replacing it.
• batchMovePage write Move many Pages to one destination: a new parent Page and/or a new Space: in a single auditable operation, instead of one move per page.
• browsePages read Open the user's Cloud pages in an interactive view inside the chat: browse a Space, search, and read a page without leaving the conversation.
• commentOnPage write Anchor a comment to a passage on a Page: name the block by the blockId returned by readPage and quote the exact text inside it you are responding to.
• createPage write Create a Page: a rich document in a Space.
• createSpace write Create a Space: a top-level workspace that holds Pages.
• createSpaceInviteLink writeconsent Create a one-time Space invite link when you need to get a person into a Space but do not have their email or a resolved Cloud account.
• deleteBlocks writedestructive Delete one or more top-level page blocks by blockId.
• deletePage writedestructive Delete a Page: moves it to trash, restorable, same as deleting from the UI.
• deleteSpace writedestructive Delete a Space the user owns: permanently.
• editPage write ⚠️ DESTRUCTIVE: REPLACES THE ENTIRE PAGE BODY.
• editSection write Replace the body of one section of a page: the blocks under a heading: leaving the heading and the rest of the page untouched.
• followPage write Follow a page for the account you act for, so that person gets one quiet in-app notice in The Cloud when someone else, or someone else's AI, changes it.
• insertAfterBlock write Insert markdown immediately after one top-level page block by the blockId returned by readPage.
• insertComponent write Place a real typed component: a status chip: into a page body at a chosen anchor.
• insertContent write Insert markdown into a page at a chosen anchor: additively, without replacing anything.
• insertDialogueCallout write Write an attributed-dialogue transcript into a page as real callout blocks: one block per turn, each carrying who said it and a real avatar: Ora as the cloud mark, a person by photo/initials, a…
• listComponentTypes read List the typed block components insertComponent can author and the exact props each accepts: schema discovery, so you author against the real component contract instead of guessing.
• listDaysSharedWithMe read List the My Day pages other people shared with the user, directly or with a Space the user belongs to, newest day first, each with its link, who shared it and through which Space.
• listFollowedPages read List the pages the account you act for follows, newest follow first, each with its link.
• listPageComments read List the comments people anchored to passages on a Page: each with the blockId and quoted text it answers, the comment itself, its author, and anchorState ("attached", or "passageChanged" when the…
• listPageFiles read List the files attached to a Page: PDFs, audio, and images embedded in the page body: each with a fileId, name, type, and whether its content can be read (textAvailable).
• listPages read List Pages in a Space, or audit exposure across ALL your Spaces.
• listPageSpaces read List the user's Spaces: the workspaces that contain Pages.
• listSignInApps read List the Sign in with The Cloud apps (OpenID Connect clients) of one Space you own or administer.
• listSpaceContents read List everything in a Space in one call: its pages, forms, tables, Studio apps, task lists, folders, and Files: so a Space reads as a real project hub.
• listSpaceMembers read List the members of a Space and their roles (owner / admin / member).
• movePage write Move a Page under a new parent Page to build a hierarchy.
• moveSection write Relocate a section of a page: a heading and its body: to a new spot, without rewriting the page.
• readPage read Read a Page's content as markdown, with a <!-- block:<blockId> --> address after every top-level block.
• readPageFile read Read the content of a file attached to a Page: a PDF's text layer, a DOCX/CSV/TXT/MD document, an audio transcript, or an IMAGE.
• registerSignInApp write Register an app that signs a Space's members in with their Cloud account over OpenID Connect, and get its client id and secret.
• rehearseOwnershipTransfer read Rehearse handing a Space to another Cloud account, by user id or account email.
• renamePage write Rename a page's title only: the body stays unchanged.
• replaceBlock write Replace one top-level page block by the blockId returned by readPage.
• resolveAccount read Resolve a person to a Cloud account that can be used as a shareSpace target.
• searchPages read Search Pages across the user's Spaces BY MEANING as well as by title.
• setPagesVisibility writeconsent Bulk Page visibility sweep: up to 50 pages in one call.
• setPageVisibility writeconsent Change a Page's visibility.
• setRecurringIconPreference write Set what happens when the person changes the icon on a page that repeats: "ask" shows a Repeat every time / Just this one prompt, "always" carries the new icon to every future page, "never" keeps it…
• setRecurringPageIcon write Set the icon on a page that repeats (My Day, its Ora tab, a tab a template or repeat rule brings back) for this page only or for every future page the recurrence makes.
• shareMyDay writeconsent Share a day of the user's own My Day with a Space or with one person, read only.
• shareSpace writeconsent Request sharing a Space with a Cloud account at a role (owner | admin | member).
• tagPage write Add tags to or remove tags from an EXISTING page: the post-creation counterpart to `createPage`'s `tags` parameter.
• unfollowPage write Stop following a page for the account you act for, so no more change notices arrive for it.
• unshareMyDay writeconsent Stop sharing a day of the user's My Day: the Space or person it was shared with can no longer open it, from this moment, and it leaves their shared-with-me list.
• unshareSpace writeconsent Request removing a member's access to a Space.
• updateComponent write Re-style a status chip you placed earlier with insertComponent, addressed by its componentId.
• updateSpaceMemberRole writeconsent Request changing a Space member's role (owner | admin | member).
• verifyOwnershipTransfer read Verify a Space handover after it ran.