1. Docs
2. /
3. Tool reference
4. /
5. Studio Apps

Studio Apps

Real multi-file apps built inside the workspace: files, manifests, secrets, rendering, sharing, and verification.

117 verbs in this family.

• abortStudioAppUpload write Discard an open Studio upload and every file staged in it.
• addCustomDomain writeconsentexternal Connect a custom domain to this account and start verifying it, optionally binding a Studio app to serve the whole site in the same call.
• addSlide write Add one slide and its element rows to a Studio Slides deck through the shared attributed write path.
• appendStudioAppFile write Append content to a file in a Studio app additively: no whole-file round-trip.
• applyForPublicListing writeconsent Apply for a Studio app to be listed publicly in the App Library, free or paid: the "Public" answer to where an app lives (Private is makeStudioAppPrivate, a Space is moveStudioAppToSpace).
• applyTheme write Apply a validated JSON theme description to a Studio Slides deck through the shared attributed write path.
• archiveStudioApp writedestructive Archive a Studio app: move it to the recoverable Archived section.
• assignStudioAsset write Assign an uploaded asset to a placeholder slot in a Studio app: the DETERMINISTIC placement: exact file path + exact slot name, no fuzzy matching.
• attachSecretToApp write Attach an account-level secret to a Studio app: declares it in the app's capability surface (requestedSecrets) so the runtime proxy can inject it.
• attachStudioAppArtifact write Attach a build output to a tagged release.
• beginStudioAppUpload write Open a staged upload for a Studio app, so a multi-file bundle (a site's pages, styles, scripts and data) goes live in ONE step instead of file by file.
• bindApexStudioSite writedestructiveconsent Cut the apex hostname over to the seeded Studio site.
• checkSecretExists read Check whether a Studio app secret is set: returns a BOOLEAN only, never the value.
• checkSeo readexternal Run the search and discovery checklist against one site and file the result as a report Page.
• checkStudioApp read Check the runtime health and discovery head of a Studio app.
• commitStudioAppUpload write Make a staged Studio upload live: every staged file lands in ONE transaction, so a visitor sees either the whole old tree or the whole new one.
• copyStudioAppFile write Copy ONE text file server-side from its current stored bytes to a new path, inside one Studio app or into another, without sending the content through the caller.
• copyStudioAppFiles write Copy text files from one tagged Studio app release into another Studio app without sending file bodies through the caller.
• crawlSiteToContent writeexternal Crawl a public website into a Studio content pack.
• createDeck write Create a private Studio Slides deck for the caller or in a Space they can edit.
• createDocSkill write Create a docSkill: the document analog of a Studio template: the refined structure, formatting, tone, and method for a document CLASS (memo, SOP, retainer letter, proposal, brief, offer letter),…
• createGallery write Create ONE private Studio gallery link with our pick and reasons, comparison, every item opening as a full lens, every photo, sourced facts and dates, seller prices, location, reviews, and "Book…
• createMapEmbedInstallation writeconsent Install the shared map planner for one host: a Studio app (hostAppId) or an outside site (allowedOrigin, a bare https origin like https://example.com), never both.
• createStudioApp write Create a new Studio app: a first-class Cloud object that renders at `thecloud.so/a/<slug>_<id>` and can be embedded in pages via the App Window block.
• createStudioAppFileFromTemplate write createStudioAppFileFromTemplate: make a NEW page in a Studio app from a page that already exists: copy `templatePath` to `newPath`, filling the template's slots as you go, so a guide, a listing or a…
• deleteStudioAppFile writedestructive Delete a file from a Studio app by path.
• deleteStudioAppSecret writedestructive Delete a Studio app secret.
• diffStudioAppTree read Diff a local file tree against a hosted Studio app and get back ONLY what differs: the first call of a release, so a seat learns which files to upload without listing and hashing the whole hosted…
• draftArticle write Draft an article for The Journal on the platform site.
• editSlide write Edit a slide title, notes, background, or replace its ordered elements through the shared attributed write path.
• editStudioAppContent write Replace a Studio app's contentHTML: the HTML the iframe renders at `/a/<slug>_<id>`.
• editStudioAppFile write Surgically edit one file in a Studio app by find-and-replace: patch it in place instead of re-uploading the whole file.
• editStudioAppFileBatch write Apply an ORDERED list of find-and-replace edits to one file in a Studio app, ATOMICALLY (all-or-nothing) in a single call.
• editStudioAppManifest write Replace a Studio app's manifest: the capability declarations (requestedTools, requestedScopes), hosting mode, pricing, review status, and PER-PAGE PRIVACY.
• exportDeck write Export a Studio Slides deck the caller can edit as a PDF or a PowerPoint file, store it, and return the download URL.
• forkDocSkill write Fork a docSkill you can read into your own library: a NEW customized copy with a forkOf pointer back to the parent.
• getDocContract read Resolve a named deliverable to ITS CONTRACT for you: your own override if any, else your org's, else the platform default (resolution order: user > org > platform).
• getStudioSiteRedirects read Read a Studio site's redirect table: every old path the owner retired and the live path it answers with now, as stored in the app's `redirects.json`.
• importMediaToApp writeexternal Import real media into a Studio app from consented external pages: a server-side render-then-harvest that lands deduped image files in the app's assets/ tree with provenance (source URL +…
• linkStudioAppDomain writeconsent Point a custom domain at a Studio app, which then serves the whole site at that domain: the root and every path.
• lintStudioComposition read Lint a Studio app for the Composition Layer gates: (1) the SCROLL-SHELL guarantee: a top-level header pinned (position: fixed/sticky) WITHOUT the shell that keeps it stable inside the render iframe…
• listArchivedStudioApps read List your archived Studio apps, most-recently-archived first.
• listArticles read List The Journal's articles on the platform site: title, slug, kind, topics, path, and whether each is published or still a draft.
• listCustomDomains read List the custom domains on this account with their status, the Studio app each one serves, the canonical host the hosting layer reports, the DNS records still outstanding, and servingTruth: a live,…
• listDeckChanges read List the bounded attributed change history for a Studio Slides deck, including human or AI origin and undo links.
• listDocContracts read List the doc contracts: the stable, named deliverable SHAPES available to you: your own overrides, your org's, and the platform defaults you inherit.
• listDocSkills read List your docSkills: the document skills in your universal library, most-recent first.
• listMapEmbedInstallations read List every map planner installation of one provider Space, active and revoked: host, mode, what it may offer and where its leads land.
• listStudioAppAdmins read List a Studio app's admin config, all THREE routes that reach admin on it: the owner plus the explicit `adminUserIds` allowlist; whether admins also resolve from the containing Space (`adminSource`…
• listStudioAppArtifacts read List the build artifacts released from a Studio app: the zips, binaries and generated file sets attached to its tagged versions.
• listStudioAppFiles read List the files in a Studio app, sorted by path: returns each file's path, mimeType, byteSize, contentSha and updatedAt (no content, that's readStudioAppFile).
• listStudioApps read List the Studio apps the caller can reach, newest created first.
• listStudioAppSecrets read List Studio app secrets: METADATA ONLY: key, scope, isSet (always true for a listed secret), browserExposed (whether the served app's page can read it), browserExposable (whether it may be exposed…
• listStudioAppShares read List teams the Studio app is shared with.
• listStudioAppUploadFiles read List every file staged in a Studio upload with its path, byteSize, mimeType and contentSha (sha256 of the staged content, the same digest readStudioAppFile reports after commit).
• listStudioAppVersions read List a Studio app's version history, newest first.
• listVercelProjectEnv readexternal List a Vercel project's environment variables: key, targets, type and last update only; never a value.
• makeStudioAppPrivate writeconsent Make a Studio app private: the "Private" answer to where an app lives.
• mirrorStudioAppAsset writeexternal Mirror a public binary asset into a Studio app under assets/ by URL.
• mirrorStudioAppAssets writeexternal Mirror a whole MANIFEST of public binary assets into a Studio app's assets/ tree in one background job, instead of one call per URL.
• mountVerbPack write Mount an owned Studio verb pack into the caller's MCP catalog.
• moveStudioAppToSpace write Move a Studio app into a Space so it lives with its project, instead of the owner's global Studio library.
• placeStudioMedia write Place an already-uploaded media file into a spot in a Studio app, resolving a VAGUE mention to the right file + spot.
• prerenderStudioSite write Pre-render every route of a SITE CLASS Studio app so the FIRST response carries the page's copy instead of an empty shell.
• promoteDocContract write Promote one of YOUR ratified user-scope doc contracts to the PLATFORM DEFAULT: the commons floor every account inherits, including provisioned and staged ones (by resolution, never by copy).
• publishArticle writeconsent Publish a drafted Journal article to the platform site.
• readAuthSpace read Read who may sign in to one app: "open" admits anyone with a Cloud account, "invite" admits only the people already on the app's member list.
• readDeck read Read one Studio Slides deck with its ordered slide rows and element rows.
• readStudioApp read Read a Studio app: returns its name, contentHTML, manifestJSON, canonical URL, and its CITATION surface: `version` (the content hash of the app's current file tree) and `releases` (every tagged…
• readStudioAppFile read readStudioAppFile: read one file from a Studio app and get its CONTENT (plus mimeType): the canonical way to read a page, a stylesheet or a script, the verb every other file tool points to.
• readStudioAssetMirrorJob read Read the progress and per-item results of a Studio asset mirror job started by mirrorStudioAppAssets.
• rebuildStudioApp write Rebuild a Studio app: reconcile it onto its canonical store so what the public /a/ route serves and what tools report agree.
• registerDocContract write Register a NEW doc contract at version 1: a stable, named deliverable SHAPE others resolve and render.
• removeSlide writedestructive Remove one slide and its elements from a Studio Slides deck through the shared attributed write path.
• renameStudioApp write Rename a Studio app.
• renderShareCard write Rasterize self-contained HTML or SVG into a pixel-perfect share-card PNG and save it as a PRIVATE asset in a Studio app.
• renderStudioApp read Render a Studio app headlessly and return SCREENSHOTS Ora can inspect.
• reorderSlides write Reorder every slide in a Studio Slides deck using an exact permutation of its slide ids.
• restoreStudioApp write Restore an archived Studio app: bring it back whole (files, history, and settings all intact).
• retireCustomDomain writedestructiveconsent Retire a DEAD custom domain row from this account: one that reads superseded (it moved to another account after they verified DNS ownership) or challenge_pending (a takeover that never verified).
• revokeMapEmbedInstallation writedestructive Turn off one map planner installation.
• rotateStudioAppSecret writedestructive Rotate a Studio app secret: replace its value with a new one.
• searchStudioAppFile read Search the current text files of a Studio app with a safe JavaScript regular expression, without paging whole files through readStudioAppFile.
• seedApexStudioSite writeexternal Create or refresh the platform's public-site Studio app from the live marketing tree.
• setAuthSpaceMode writeconsent Set who may sign in to one app.
• setConvexEnv writedestructiveexternal Set one environment variable on a Convex deployment named explicitly, e.g.
• setDomainDiscoverySettings write Configure Google Search Console verification for a domain you manage.
• setDomainPathRoutes writeconsent Set the path routes on a custom domain that serves a Studio app: reserved prefixes the edge sends to an external https origin instead of the app, so myai.so/workspace can serve a console while the…
• setStudioAppAdmins writeconsent Set who administers a Studio app.
• setStudioAppClass write Convert an EXISTING Studio app to site class in place, or back to an ordinary app.
• setStudioAppFavicon write Set or remove a Studio app's favicon: the icon its tab, bookmark, and home-screen shortcut wear.
• setStudioAppIcon write Set or remove a Studio app's icon, the one shown beside its name in Studio lists and cards, the app window, share cards and Explore.
• setStudioAppSecret writedestructive Set (create or overwrite) a Studio app secret's value: WRITE-ONLY.
• setStudioAppSecretBrowserExposure writedestructiveconsent Make an app-scoped Studio secret readable by the app's served page in the browser (window.cloud.browserKeys), or take it back out.
• setStudioAppShareCard writeconsent Request setting a Studio app's link-preview share card: the title, description, and cover image a shared /a/<slug>_<id> link unfurls with on Telegram/Slack/iMessage/social.
• setStudioAppVisibility writeconsent Request a Studio app visibility change (public ↔ private).
• setStudioSiteRedirects write Replace a Studio site's WHOLE redirect table, so retired URLs 301 to their live paths on the app's custom domain and on its /a/ link alike.
• setVercelProjectEnv writedestructiveexternal Create or update one environment variable on a Vercel project, for the targets named (production, preview, development).
• shareStudioApp writeconsent Request sharing a Studio app with a team.
• stageStudioAppUploadFile write Stage one text file into an open Studio upload by passing its full content.
• stageStudioAppUploadFromMachine write Stage files into an open Studio upload straight from a path on one of your MachineSync boxes, so no file passes through a model's output.
• syncGalleryFromTable write Refresh a table-backed Cloud Gallery from the Cloud table and column mapping stored inside the app.
• tagStudioAppVersion write Cut a release: give a Studio app version a permanent human name, so an outside document can cite exactly which design state it came from.
• transferCustomDomain writedestructiveconsent Transfer a custom domain to another Cloud account by user id or account email.
• transferStudioApp writedestructiveconsent Transfer a Studio app to another Cloud account by user id or email.
• undoDeckChange write Undo the latest active human or AI edit to a Studio Slides deck as a new attributed compensating change.
• unlinkStudioAppDomain writeconsent Detach whichever Studio app a custom domain serves, so the domain stops serving that site.
• unmountVerbPack write Unmount an owned Studio verb pack from the caller's MCP catalog.
• unpublishArticle writeconsent Withdraw a published Journal article.
• unshareStudioApp writeconsent Request removing a team's share on a Studio app.
• updateDocContract write Publish a NEW version of an existing doc contract: update = a new version.
• updateGalleryCollection write Refine an existing Cloud Gallery without rebuilding its engine.
• uploadStudioAppAsset write Upload a REAL BINARY FILE (an image, an icon, a font) into a Studio app's `assets/` tree, so the app serves it at a normal path with a real content type: no data-URI in the markup, and no waiting…
• validateAgainstDocContract read Check a drafted deliverable against the contract it claims, BEFORE filing it.
• validateStudioApp read Parse a Studio app's own source and report SYNTAX ERRORS with file, line and column: the verify-back loop that needs no browser at all.
• verifyCustomDomain writeexternal Re-run verification on a custom domain you manage, wait for it to finish, and report where it stands now.
• writeStudioAppFile write Create or overwrite a file in a Studio app.