VibeDeploy

 ⟨19 unchanged words⟩  MCP responses.","type":"string"},"customDomains":{"anyOf":[{"additionalProperties":false,"properties":{"allowance":{"description":"Custom domains the team's current plan includes.","type":"number"},"connected":{"description":"Custom domains on this site from both sources, one entry per hostname.","items":{"additionalProperties":false,"properties":{"domain":{"description":"Hostname, e.g. shop.example.com.","type":"string"},"source":{"description":"dashboard: linked on the dashboard Web Addresses page. mcp: added with add_custom_domain or the site API.","enum":["dashboard","mcp"],"type":"string"},"status":{"description":"live: verified and serving this site. pending: linked, not verified yet.","enum":["live","pending"],"type":"string"}},"required":["domain","status","source"],"type":"object"},"type":"array"},"nextTool":{"const":"add_custom_domain","description":"Present when this site has no custom domain yet and the team has room for one.","type":"string"},"used":{"description":"Distinct custom domains in use across the team, both sources (same count as get_account).","type":"number"}},"required":["connected","allowance","used"],"type":"object"},{"type":"null"}],"description":"Custom domains of this site and the team's custom-domain allowance; null when they could not be read."},"filesDeployed":{"type":"number"},"manageUrl" ⟨60 unchanged words⟩ ","outputDir","totalBytes","manifest","buildLog","customDomains"],"type":"object"}

 ⟨41 unchanged words⟩  dev and app. Not tied to a site. The result states whether the user's plan includes buying domains in the dashboard (purchase.dashboardUrl); a domain the user already owns is connected with add_custom_domain.

 ⟨63 unchanged words⟩ ), or null if the lookup failed."},"unavailableReason":{"description":"Set when the registrar lists the name as free but VibeDeploy cannot register it. MULTI_YEAR_ONLY: this extension is only sold for two years or more, and VibeDeploy registers and renews one year at a time.","type":"string"}},"required":["domain","available","priceCents ⟨6 unchanged words⟩ description":"Whether the domain can be registered through VibeDeploy right now.","type":"boolean"},"currency ⟨25 unchanged words⟩  was bought.","type":"string"},"ownDomain":{"description":"How a domain the user already owns is connected instead.","type":"string"},"priceCents":{"anyOf":[{"type":"number ⟨12 unchanged words⟩  or null when no price is published."},"purchase":{"additionalProperties":false,"description":"Whether and where the user can buy a domain through VibeDeploy.","properties":{"allowedOnPlan":{"description":"Whether the user's current plan includes buying domains through VibeDeploy.","type":"boolean"},"dashboardUrl":{"description":"Dashboard page where the user buys domains. Buying always happens there, never through this tool.","type":"string"},"reason":{"description":"Neutral statement of why buying is not possible. Present only when allowedOnPlan is false.","type":"string"}},"required":["allowedOnPlan","dashboardUrl"],"type":"object"},"unavailableReason":{"description":"Set when the registrar lists the name as free but VibeDeploy cannot register it. MULTI_YEAR_ONLY: this extension is only sold for two years or more, and VibeDeploy registers and renews one year at a time.","type":"string"}},"required":["available","domain","priceCents","currency","note","purchase","ownDomain"],"type":"object"}

{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"customDomains":{"anyOf":[{"additionalProperties":false,"properties":{"allowance":{"description":"Custom domains the team's current plan includes.","type":"number"},"connected":{"description":"Custom domains on this site from both sources, one entry per hostname.","items":{"additionalProperties":false,"properties":{"domain":{"description":"Hostname, e.g. shop.example.com.","type":"string"},"source":{"description":"dashboard: linked on the dashboard Web Addresses page. mcp: added with add_custom_domain or the site API.","enum":["dashboard","mcp"],"type":"string"},"status":{"description":"live: verified and serving this site. pending: linked, not verified yet.","enum":["live","pending"],"type":"string"}},"required":["domain","status","source"],"type":"object"},"type":"array"},"nextTool":{"const":"add_custom_domain","description":"Present when this site has no custom domain yet and the team has room for one.","type":"string"},"used":{"description":"Distinct custom domains in use across the team, both sources (same count as get_account).","type":"number"}},"required":["connected","allowance","used"],"type":"object"},{"type":"null"}],"description":"Custom domains of this site and the team's custom-domain allowance; null when they could not be read. Omitted on dry runs."},"customHeaders":{"anyOf":[{"additionalProperties":false, ⟨130 unchanged words⟩ 

 ⟨13 unchanged words⟩  the site.","type":"boolean"},"customDomains":{"anyOf":[{"additionalProperties":false,"properties":{"allowance":{"description":"Custom domains the team's current plan includes.","type":"number"},"connected":{"description":"Custom domains on this site from both sources, one entry per hostname.","items":{"additionalProperties":false,"properties":{"domain":{"description":"Hostname, e.g. shop.example.com.","type":"string"},"source":{"description":"dashboard: linked on the dashboard Web Addresses page. mcp: added with add_custom_domain or the site API.","enum":["dashboard","mcp"],"type":"string"},"status":{"description":"live: verified and serving this site. pending: linked, not verified yet.","enum":["live","pending"],"type":"string"}},"required":["domain","status","source"],"type":"object"},"type":"array"},"nextTool":{"const":"add_custom_domain","description":"Present when this site has no custom domain yet and the team has room for one.","type":"string"},"used":{"description":"Distinct custom domains in use across the team, both sources (same count as get_account).","type":"number"}},"required":["connected","allowance","used"],"type":"object"},{"type":"null"}],"description":"Custom domains of this site and the team's custom-domain allowance; null when they could not be read. Omitted on dry runs."},"customHeaders":{"anyOf":[{"additionalProperties":false, ⟨160 unchanged words⟩ 

 ⟨350 unchanged words⟩ :"object"},"customDomains":{"description":"Currently attachedDistinct custom domains in use across the team.team: added with add_custom_domain or linked and bought in the dashboard.","type":"number"},"deploysLastHour":{ ⟨42 unchanged words⟩ 

 ⟨14 unchanged words⟩  is stored (and its build settings), custom domains, bandwidth and the last 10 deploys. Use get_site  ⟨18 unchanged words⟩ 

 ⟨47 unchanged words⟩ ,"windowDays"],"type":"object"},"customDomains":{"anyOf":[{"additionalProperties":false,"properties":{"allowance":{"description":"Custom domains the team's current plan includes.","type":"number"},"connected":{"description":"Custom domains on this site from both sources, one entry per hostname.","items":{"additionalProperties":false,"properties":{"domain":{"description":"Hostname, e.g. shop.example.com.","type":"string"},"source":{"description":"dashboard: linked on the dashboard Web Addresses page. mcp: added with add_custom_domain or the site API.","enum":["dashboard","mcp"],"type":"string"},"status":{"description":"live: verified and serving this site. pending: linked, not verified yet.","enum":["live","pending"],"type":"string"}},"required":["domain","status","source"],"type":"object"},"type":"array"},"nextTool":{"const":"add_custom_domain","description":"Present when this site has no custom domain yet and the team has room for one.","type":"string"},"used":{"description":"Distinct custom domains in use across the team, both sources (same count as get_account).","type":"number"}},"required":["connected","allowance","used"],"type":"object"},{"type":"null"}],"description":"Custom domains of this site and the team's custom-domain allowance; null when they could not be read."},"filePaths":{"description":"Site-relative paths of every ⟨225 unchanged words⟩ ","sourceManifest","lastDeployAt","bandwidth","history","customDomains"],"type":"object"}

Return all custom domains attached to a site.site, Eachboth entrythose hasadded with add_custom_domain (source 'mcp', with a recordId youfor canverify_custom_domain passor toremove_custom_domain) verify_custom_domainand those linked in the VibeDeploy dashboard (source 'dashboard', verified or remove_custom_domain.removed on the dashboard Web Addresses page at manageUrl). Call it before add_custom_domain to avoid adding a domain twice.

 ⟨11 unchanged words⟩ {"domain":{"type":"string"},"manageUrl":{"description":"Source 'dashboard' only: the dashboard Web Addresses page where this domain is verified or removed.","type":"string"},"note":{"description":"Source 'dashboard' only: how this entry is managed.","type":"string"},"recordId":{"description":"Pass to verify_custom_domain or remove_custom_domain. Present on every source 'mcp' entry, absent on source 'dashboard' entries.","type":"string"},"source":{"description":"mcp: added with add_custom_domain or the site API. dashboard: linked on the dashboard Web Addresses page.","enum":["mcp","dashboard"],"type":"string"},"status":{"enum":["pending_verification","verified" ⟨3 unchanged words⟩ {"additionalProperties":false,"description":"Only present whenon source 'mcp' entries whose status is pending_verification.","properties":{"name": ⟨14 unchanged words⟩ "type":"object"}},"required":["recordIddomain","domainstatus","statussource"],"type":"object"},"type": ⟨9 unchanged words⟩ 

Check the TXT recordrecords from add_custom_domain (the ownership TXT and the routing record) and, when itboth isare foundright, start serving the site on that domaindomain; (the HTTPS iscertificate issuedfollows automatically, usually within abouta 30minute s).or two. If it fails, DNSthe hasresult usuallynames noteach propagatedrecord yet:to waitadd, change or remove; DNS changes can take a few minutes andto callpropagate. Calling it again.again on a verified domain is a harmless re-check.

Start attaching a user-owned domain to an existing site.site: Returnsreturns athe TXT record the user must addadds at their DNS provider. Idempotent: calling twice with the same (siteName, and domain) returnsreturn the existing record instead of creating a duplicate.record. AfterOnce the TXT is published (typically withinusually minutes;minutes, up to 24h), call verify_custom_domain with the returned recordId. The site itself must already exist on a platform subdomain (e.g. {name}.vibedeploy.be or {name}.vibedeploy.eu).exist; Callcall deploy_site first if it doesn't.does not.

 ⟨5 unchanged words⟩ :{"description":"The user-owned hostname to attach, (e.g. 'tester.subsite.site').'shop.example.com'. Must be a valid FQDN.","type": ⟨22 unchanged words⟩ 

 ⟨27 unchanged words⟩ True when the verification TXT was written automatically because the (domain is managedregistered through VibeDeploy's Gandi account. The caller canVibeDeploy): call verify_custom_domain immediately without waiting for the user to add a TXT manually. Absent /right falseaway. meansOtherwise the user has to addadds the record at their own DNS provider before verify will succeed.first.","type":"boolean"},"domain":{ ⟨95 unchanged words⟩ ":"DNS record name to add (e.g. '_vibedeploy.tester.subsite.site''_vibedeploy.shop.example.com').","type":"string"},"type" ⟨26 unchanged words⟩ 

Stream aSend singleone file acrossin multipleseveral calls when its contentit exceedsis thetoo per-MCP-callbig outputfor budget.a LASTsingle RESORTtool —call. tryLast theseresort: first: (1)try add_files with encoding:'gzip+base64' fits(about ~250250 KB of text source in ONEone call (gzip locally, base64, send — no chunking, no ordering hazards); (2), begin_deploy's uploadUrl takes a(one 100 MB tarball in one HTTPtar POST if your sandbox can reach mcp.vibedeploy.be; (3) deploy_from_url if the files are fetchable fromor adeploy_from_url (public URL. Only chunk when none of thosearchive work.URL). When you DO chunkchunking, gzip+base64 each chunk too, —mark itthe quadruplesfirst thewith sourceisFirst bytesand perthe chunk.last Markwith theisLast, firstand chunksend withchunks isFirst=trueof (truncatesone +file mkdir)one andafter theanother: lastparallel withchunks isLast=truecorrupt (returnsit. assembledAfter size).a Sendtransport chunkserror, fordo not resend the samechunk pathblindly: seriallyrestart —the concurrentfile chunksfrom interleaveits andfirst corruptchunk the(isFirst file.truncates it).

 ⟨4 unchanged words⟩ :{"content":{"description":"This chunk's bytes. Eitherbytes, rawas UTF-8 (default)text or base64-encoded — setencoded encodingper accordingly.encoding. PRACTICALChunk CHUNKsize SIZE:is boundedlimited by your LLM client's tool-output token budget, NOTnot by VibeDeploy'sthe server.server:

AppendAdd files to an open staging session. Call as many times as needed; commit_deploy applies them all at once. Validates path/extension/encoding onbegin_deploy everysession; call so a bad file fails fast. Same 500it MBas capoften as single-call deploysneeded, but cumulativethen acrosscommit_deploy thepublishes session.them LARGEtogether. TEXTPaths, FILES:extensions aand fileencodings thatare lookschecked tooon bigevery tocall. inlineA (100-250 KB oftext HTML/CSS/JS)file usually still fits in ONEone call — gzip it locally, base64 the result, send with encoding:'gzip+base64' (text compressesgzip 3-5×locally, so ~250 KB of source ≈ ~70 KB on thethen wirebase64).; Preferprefer that over add_file_chunk: one call, no ordering hazards. Only chunk when a single file exceeds ~250 KB of source even after gzip, or when you have no way to gzip locally.add_file_chunk. If your environment can run shell but can'tcan reach this hostmcp.vibedeploy.be, gzip+base64 via add_files is the fastest path; if it CANone reachtar(.gz) thisPOST host,to begin_deploy's uploadUrl (tarball POST, 100 MB)is beatsfaster everything.still.

 ⟨12 unchanged words⟩ string"},"files":{"anyOf":[{"description":"Array form; needed for binary files.","items":{"properties":{"content":{"description":"File content: text, or base64 as set by encoding.","type":"string"},"encoding":{"description":"utf8 (default) for plain text., base64 for (binary files (images, fonts), PDFs).or gzip+base64 ships ~3–5× more raw text per tool call: (gzip the bytes locally first, then base64. Server gunzips before writing. Per-filebase64; decodedfits size3-5x cappedmore attext 500

Apply literal find/replace edits acrossto MANYseveral files in one toolcall, call.in Batchthe siblingserved offiles update_file_content.(target Per-file'dist', editlive semanticsat identicalonce) (count:or 1the default,editable -1source =(target all'source', positive int assertsshipped exactby countbuild_and_deploy). WholeSame calledit isrules atomicas acrossupdate_file_content. filesAll or nothing: validationif runsany first,edit's writesmatch onlycount proceeddiffers iffrom everyits edit'sexpected count, checkno passes.file is written.

 ⟨47 unchanged words⟩ "items":{"properties":{"count":{"description":"Expected matches: default 1, -1 = replace all, or an exact number.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"find":{"description":"Literal text to find (not a regex). Max 64 KB.","maxLength":65536,"minLength":1,"type":"string"},"replace":{"description":"Literal replacement; empty string deletes the match. Max 64 KB.","maxLength":65536,"type":"string"}}," ⟨8 unchanged words⟩ :"array"},"path":{"description":"File-relative pathPath inside the chosen target.tree, e.g. index.html.","type":"string"}},"required": ⟨7 unchanged words⟩ 1,"type":"array"},"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio.","type":"string"},"target":{"description ⟨26 unchanged words⟩ 

OpensOpen a staging session for a multi-call deploy. Use when thedeploy sitethat is too large to fit in afor singleone deploy_site/update_sitecall: call.stage Pairfiles with add_files (one or more timesrepeatable), ORadd_file_chunk, aor singleone tarballtar(.gz) uploadPOST to the returned uploadUrl, then publish with commit_deploy. ActiveUse sessionbegin_deploy limitonly when the files do not fit in one deploy_site or update_site call. Up to 5 open sessions per token:token; 5.a Defaultsession TTL:expires after 1 hour.

 ⟨51 unchanged words⟩ :"string"},"name":{"description":"Site name to deployName to.of Mustan alreadyexisting exist;site multi-call(see sessionslist_sites). don'tSessions auto-createdo sitesnot —create usesites; deploy_site for that, or call this against an existing site.does.","type":"string"}},"required": ⟨4 unchanged words⟩ 

 ⟨56 unchanged words⟩ :"string"},"uploadToken":{"description":"Same single-purposeThe token already embedded in uploadUrl, exposed separately if you'd rather pass itfor viaan Authorization: Bearer header than as a query parameter.instead. Valid only for POST /upload/<this deployId>. Cannot bedeployId>, usednot for /mcp tool calls or any other deploy session.sessions.","type":"string"},"uploadUrl":{"description":"POST a tar(.gz) archive to this URLhere to stage many files in one HTTP call —, bypassesoutside the per-tool-calltool-call

Run aBuild buildthe insidesite's astored hardenededitable one-shotsource podin againstan theisolated site'sone-shot editablebuild sourcepod treeand (writeatomically sourcepublish firstthe viaoutput write_source_filesas /the list_source_fileslive autoPromote)site, then atomically swapreplacing the buildserved outputfiles into(a therestore livepoint dist.is Reusesnormally thetaken samefirst). buildUse podbuild_and_deploy theafter GitProjectchanging git-deploystored flowsource uses(write_source_files, soapply_edits thewith sametarget isolation'source'); guaranteesuse apply:update_site noinstead SAto token,upload nofiles DB/Vaultthat reach,are NetworkPolicy-restrictedalready egress.built. The first runbuild writessaves thebuildCommand, chosenoutputDir buildCommand/outputDirand intorootPath Site.sourceManifest;on subsequentthe site, so later calls can omit thosethem. fields.A failed build returns its log in the error details.

 ⟨3 unchanged words⟩ ,"properties":{"buildCommand":{"description":"Override for the build script's `npm runBuild build`command stepoverride, (e.g. 'npm run build:prod' or 'pnpm vite build'). If omitted,build'. usesDefault: the manifest stored on thesaved sitemanifest, then falls back to 'npm run build'.","type":"string"},"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"outputDir":{"description":"Override for which directoryDirectory to shippublish. asDefault: the new dist. If omitted, uses thesaved

 ⟨23 unchanged words⟩ ,"filesDeployed":{"type":"number"},"manageUrl":{"description":"Dashboard page where the user manages this site (domains, versions, settings).","type":"string"},"manifest":{"additionalProperties":false,"properties":{" ⟨23 unchanged words⟩ "},"totalBytes":{"type":"number"},"url":{"description":"Live URL of the site.","type":"string"}},"required":["siteId","name","url","manageUrl","filesDeployed","outputDir","totalBytes","manifest ⟨3 unchanged words⟩ 

{"destructiveHint":falsetrue,"idempotentHint":false,"openWorldHint":true,"readOnlyHint":false}

Check whether a domain can be registered and get an INDICATIVE retail price.indicative IMPORTANT:price this(VAT isincluded awhere read-onlyit lookupapplies). —Read-only: it does NOT buy,never registerbuys, reserve,registers or pay for any domain, and it changes nothing. The returned price is GROSS (includes 21% VAT) and indicativereserves only.a Setdomain. alternatives:true to also checkchecks the same name across other common TLDson (be, com, net, eu, nl, io, dev, app). Requires a valid team token butand isapp. notNot tied to a specific site.

 ⟨51 unchanged words⟩ {"type":"null"}],"description":"GrossIndicative (incl.price 21%in cents (VAT) indicativeincluded pricewhere init centsapplies), or null if pricing/availabilitythe lookup failed."}},"required":["domain" ⟨35 unchanged words⟩ },"note":{"description":"Reminder that thisthe isprice anis indicative gross price and not

Atomically applyPublish a stagingbegin_deploy session's staged files to the live site.site Runsin preflightone +atomic secret/malwarestep, after a secret and malware scan againstof the complete staged set;set (on failure the session stays open and can beto re-attemptedretry or aborted.abort). ForReplace replace-modemode againston a site withthat existinghas files, requiresneeds confirm:"I-want-to-replace-all-files". If the callAfter timesa outtimeout or thedropped connection drops, call commit_deployit again with the same deployId: it returns the outcomerunning ofor thefinished commit thatinstead isof stillstarting runninga orsecond justone. finishedUse insteadcommit_deploy ofonly startingto finish a secondbegin_deploy one.session; deploy_site and update_site publish in one call.

 ⟨40 unchanged words⟩ :"string"},"delete":{"description":"Patch-modePatch mode only: site-relative paths to remove from the live site as part ofin this commit. Useful for renamescommit (write newe.g. paththe viaold add_files,path deleteof olda pathrenamed herefile).","items":{"type":"string" ⟨10 unchanged words⟩ :"string"},"dryRun":{"description":"If true, preview what commit would do without touching the live site or scratch dir. ReturnsPreview the 

 ⟨30 unchanged words⟩ :"null"}],"description":"Result of thesyncing Netlify-stylethe _headers sync: overrides appliedfile toin the site's responsesite headers,root plus(site-wide any/* validationresponse warnings.headers)."},"deletedFiles":{"items":{"type" ⟨18 unchanged words⟩ "boolean"},"filesDeployed":{"type":"number"},"manageUrl":{"description":"Dashboard page where the user manages this site (domains, versions, settings). Omitted on dry runs.","type":"string"},"mode":{"enum":["replace" ⟨45 unchanged words⟩ 

Create a manual snapshot (backuprestore point) for a site

Take a point-in-time Longhorn snapshot of a site's served files.files, Ita doesrestore notpoint changethe serveduser can restore in the VibeDeploy dashboard within the plan's restore window. Served content does not change, but retention cleanup may remove older backups.snapshots. Container data is not included. Requires an owner or admin team role. Returns NO_VOLUME ifmeans the site has no volume yet (it haswas never been deployed).deployed.

 ⟨5 unchanged words⟩ {"description":"Optional human-readable label for this backup.snapshot.","maxLength":200,"type":"string"},"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"}},"type":"object"}

Delete a site (soft,restorable 7-dayuntil recoverypurged)

Soft-delete a site. confirm=true is required. The site moves to status 'deleted' immediately (its hostname is freedconfirm:true andrequired). itIt stops serving), at once and is fully purged after the team'splan's recoveryrestore window by a sweeper. Use this(purgesAt forin the normal 'remove this from my dashboard'result); flow.until Thethen responsethe fielduser 'accepted'can isrestore trueit whenin the soft-deleteVibeDeploy isdashboard. recorded;Use thedelete_site responseto alsoremove includesthe 'purgesAt'whole sosite; youuse canremove_app tellinstead theto userstop whenonly recoveryits becomescontainer impossible.services.

 ⟨17 unchanged words⟩ ,"type":"boolean"},"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"}},"required":[" ⟨3 unchanged words⟩ 

 ⟨11 unchanged words⟩ string"},"purgesAt":{"description":"ISO timestamptime whenthe site is purged for good: the soft-deleteend becomesof athe hardplan's purgerestore (~7window. daysUntil fromthen now).it can be restored in the VibeDeploy dashboard.","type":"string"},"siteId":{ ⟨15 unchanged words⟩ 

Remove one file from the site's editable source tree. The served distfiles isdo unchanged.not change until build_and_deploy runs.

{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"path":{"description":"Source-relativePath pathinside the source tree to delete.delete, e.g. 'src/old.css'.","type":"string"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"}},"required":[" ⟨3 unchanged words⟩ 

DeployRun orcontainer updateservices thenext site'sto containera servicessite, from any public image: the user's own backend server (running code from the site's source tree), a database (Postgres,such MySQL,as MongoDB,Postgres ...)or MySQL, Redis, backgroundor workers, fromeach anyin publica image.gVisor Appliessandbox. The call applies the whole config: services missing from it are stopped (their volumes and data are kept). Waits until every service is ready, then returns per-service status; on failure call get_app_status with logs to debug. Each call restartsand the services, whichothers alsorestart, pickspicking up new source files. App config: { "services": { "<name>": { "image": "postgres:16-alpine", "port": 5432, "public": false, "command": [...], "args": [...], "workingDir": "/app", "env":It {waits "KEY":until "value"every },service "volumes":is {ready "/var/lib/postgresql/data":and "1Gi"returns },per-service "source":status; false,if "sourcePath":one "/app",is "memory":not "256Mi"ready, "cpu": "500m" } } }. Any public image works. Services reach each other by service name (e.g. host "db",call portget_app_status 5432).with Exactlylogs. oneOne service may be "public": true; it receives all HTTP traffic forserves the site's domains on its "port" (plain HTTP, TLS is terminated for you). "source": true copies the site's source tree (write_source_files) into sourcePath (default /app, writable)traffic on every start, so e.g. {"image":"node:22-alpine","source":true,"command":["sh","-c","npm ci &&its nodeport. server.js"],"port":3000,"public":true}.Use "${generated:NAME}" as an env value is a random secret generated once and shared by every service that references it (use it for database passwords); "$(OTHER)" embeds an earlier variable of the same service, e.g. "DATABASE_URL": "postgres://app:$(DB_PASSWORD)@db:5432/app". Secrets from outsidepasswords. (API keys, OAuthand clientother secrets,outside tokens)secrets never go in the config, the source or the chat: the user adds them in the VibeDeploy dashboard (the site'ssite Settings tab, section Secrets; get_app_status returns the direct link as secrets.manageUrlSecrets). Everyand every service getsreceives them as env vars and restarts automatically; an explicit env entry with the same name wins. get_app_status lists the secret names that are set, never their values. Volumes persist across deploys; everything else is recreated.environment Forvariables. PostgresPer setsite: PGDATAup to a subdirectory of the volume. Outbound internet works (not SMTP port 25); private networks are blocked. Limits per site: 6 services, 2048Mi memory and 2000m CPU in total (default 256Mi / 500m per service), 4 volumes, 3Gi storage. Container volumes are not included in snapshots yet.

 ⟨5 unchanged words⟩ "additionalProperties":{},"description":"The app config object.config; Omitomit it to use vibedeploy.json from the site's source tree. App configShape: { \"services\": { \"<name>\": { \"image\": \"postgres:16-alpine\", \"port\": 5432, \"public\": false, \"command\": [...], \"args\env\": [...], {\"workingDir\KEY\": \"/app\value\

{"destructiveHint":falsetrue,"idempotentHint":false,"openWorldHint":true,"readOnlyHint":false}

Publish a website to a live URL fromFetch a public archive link. Point this at a tar(.gz) archive onover githubHTTPS /and gistdeploy /its S3files andto thean serverexisting fetchessite andin deploysone it,call no(begin_deploy, upload fromand yourcommit_deploy side.combined). Server-sideUse fetchdeploy_from_url ofwhen athe tar(.gz)files archiveare fromalready published at a public HTTPS URL, thensuch deployas itsa contents.repository Sidestepsarchive that holds only the casebuilt wheresite your(no code-executiondotfiles), sandboxor canwhen reachyour githubsandbox /reaches gistthe /allowed S3hosts etc.(listed under archiveUrl) but not mcp.vibedeploy.be's uploadmcp.vibedeploy.be; endpoint.otherwise Equivalentuse todeploy_site begin_deployor →update_site. POSTIn uploadUrlreplace →mode commit_deployone intop-level onefolder call.that Hostnamewraps allowlistevery enforced;file see(as thein archiveUrlrepository description.archives) Replaceis moderemoved, onand a site that already has files needs confirm ⟨11 unchanged words⟩ 

 ⟨5 unchanged words⟩ "description":"Public HTTPS URL of a tar(.gz) archive. The serveror fetchestar.gz itarchive (max 100 MB, 60s60 timeouts). Allowed hosts, parsesalso thefor tarballevery redirect: github.com, codeload.github.com, *.githubusercontent.com, gist.github.com, gitlab.com, bitbucket.org, codeberg.org, *.amazonaws.com, *.r2.cloudflarestorage.com, *.backblazeb2.com, *.workers.dev, *.pages.dev, transfer.sh, 0x0.st, mcp.vibedeploy.be. GitHub, GitLab and deploysCodeberg itsarchive files.links 

 ⟨12 unchanged words⟩ ,"filesDeployed":{"type":"number"},"manageUrl":{"description":"Dashboard page where the user manages this site (domains, versions, settings).","type":"string"},"mode":{"enum":["replace","patch" ⟨5 unchanged words⟩ ,"siteId":{"type":"string"},"strippedPrefix":{"description":"Top-level folder removed from every archive path (replace mode, when one folder wraps all files).","type":"string"},"url":{"type":"string"}},"required":["siteId","name","url","manageUrl","mode","filesDeployed","bytesFetched","archiveUrl ⟨2 unchanged words⟩ 

Publish a website to a live URL. Deploy a static site or single-page app you builtto (witha AIlive orHTTPS byURL hand)on tothe youraccount's platform subdomain (e.g. {name}.vibedeploy.be or {name}.vibedeploy.eu) with automatic SSL, and optionally a custom domain. The fastest way to get a localhost project. orA annew AI-generatedname sitecreates online.the DESTRUCTIVEsite. onAn existing sites: replaces every file on the named site withname theREPLACES suppliedEVERY set.FILE Files(files not in this call are deleted. For a new site, createsdeleted) and provisions it. For an existing site, requiresneeds `confirmconfirm: "I-want-to-replace-all-files"` to proceed; without confirm the call is rejected before; anythingpreview iswith touched.dryRun:true. Use update_site (default mode:'patch') if you wantinstead to add or change individualsome files without removing the rest. Use dryRun:true to preview the diff. LARGE FILES: don't split a big text file across a placeholder deploy +of chunkedan follow-upsexisting —site. aA 100-250 KB HTML/CSS/JStext file fits in THISthis call when sent with encoding:'gzip+base64' (gzip locally, then base64); use begin_deploy only when the result;files textdo compressesnot 3-5×).fit Thein siteone iscall. publishedShip ata yourtop-level platform404.html subdomainfor multi-page sites (e.g.otherwise {name}.vibedeploy.beunknown orpaths {name}.vibedeploy.euserve index.html). Afterand deploy,use callplain add_custom_domainASCII tofile alsonames. Afterwards add_custom_domain can serve atthe asite user-ownedon hostname.the user's own domain.

 ⟨6 unchanged words⟩ :"I-want-to-replace-all-files","description":"Required when the named site already exists. Passexists: exactly \"I-want-to-replace-all-files\" to, acknowledgeconfirming that every existing file will beis deleted and replaced with this new fileset.replaced. Omit on first deploy offor a new site. If you want to add or change files without removing the others, use update_site instead — it defaults to patch mode.","type":"string"},"dryRun":{"description":"If true, validate input + introspect what would change but don't write or delete. Returns the same shapeValidate withand `dryRun:preview true`without andwriting;

 ⟨6 unchanged words⟩ :{"created":{"description":"True if the sitethis wascall created by thisthe call.site.","type":"boolean"},"customHeaders":{ ⟨23 unchanged words⟩ :"null"}],"description":"Result of the Netlify-style _headers sync: includesyncing athe _headers file in the site root to override(site-wide default/* response headers (e.g. Permissions-Policy). Site-wide (/*) rules only."},"deletedFiles":{"description":"Files that existed before this call and were removed by it. Empty for brand-newa sites.new site.","items":{"type":"string"},"type":"array"},"dryRun":{"description":"True if this wason

Return the team's plan, its limits, and current usage. Use this BEFORE deploy_site or add_custom_domain to knowusage, whetherthe atrial deployend woulddate tripand athe planper-token limit,MCP insteadrate oflimit. provokingCall PLAN_LIMIT_EXCEEDED.it Alsobefore returnsdeploy_site theor per-tokenadd_custom_domain MCPto rate-limitcheck ceilinga (liveplan remaininglimit isinstead inof X-RateLimit-Remainingrunning responseinto header).PLAN_LIMIT_EXCEEDED.

 ⟨65 unchanged words⟩ :"number"},"mcpCallsPerHour":{"description":"Per-tokenMCP captool oncalls totalallowed MCPper toolhour calls.per Livetoken; the remaining headroomcount is also returned in the X-RateLimit-Remaining HTTP response header on every call.header.","type":"number"},"sites":{ ⟨31 unchanged words⟩ :"object"},"plan":{"description":"EffectivePlan planname.

Per-service status ofShow the site's container services: per-service status (ready, restarts, waiting/crashwaiting or crash reasons, volumes), the stored config, the  ⟨19 unchanged words⟩  and optionally the recent logs of one service. Use get_app_status instead of get_site for anything about containers.

 ⟨22 unchanged words⟩ ,"type":"string"},"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"},"tail":{"description ⟨14 unchanged words⟩ 

 ⟨24 unchanged words⟩ DNS records to publish and their verification status. Submissions:The POSTsubmission JSONformat tofor the returned `endpoint` with Content-Type: application/json (UTF-8). Flat object ofsite's form fields (strings/numbers/booleans; checkbox groups may be arrays of strings, joined with ', '). Max 30 fields, 5000 chars/field, 20000 total. Response: {success:true,data:{ok:true}} or {success:false,error:{code,message}}. Rate limit: 10 submits per IP per 10 minutes. Include a hidden honeypot input (default "_gotcha") andis leavedescribed itunder empty.set_forms_config.

Return nameone site's details: live URL, urlstatus, plan, served file paths, whether editable source is stored (and its build settings), bandwidth and the last deploy10 timedeploys. Use get_site to inspect a site before editing it; use list_sites to find site names, and recentget_app_status deployfor history.container services.

{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"}},"type":"object"}

 ⟨15 unchanged words⟩  by this site over the window (usage only —only; the bandwidth cap is team-scoped, see get_account) ⟨21 unchanged words⟩ ":{"description":"Site-relative paths of every file currently on the pod (same scope as `files`). Lets a caller see what's thereserved beforefile, decidingto whichpick paths to patch or deleteread, without having to downloadpatch theor site.delete. Omitted when the livepod introspectioncannot stepbe failsinspected

 ⟨3 unchanged words⟩ properties":{"name":{"description":"Site name.name as shown by list_sites, e.g. my-portfolio. Provide thisname or siteId.","type":"string"}," ⟨18 unchanged words⟩ integer"},"siteId":{"description":"Site id.id Providefrom thislist_sites or get_site. Use instead of name.","type":"string"}},"type":"object"}

ReturnList the team's begin_deploy staging sessions, forby default the teamactive thisones token(open belongsand to.committing), Defaultsup to currently-active50. onesUseful (openafter +a committing).crash Upor restart to 50commit rows.or abort leftovers.

Read the DNS records VibeDeploy tracks for a site (the records it created/manages on your behalf), oldest first. Returns each record's host, type, and value. Any team membervalue), includingoldest viewersfirst, canincluding readcustom-domain DNSverification records. This tool is read-only andRead-only: doesit NOTnever createcreates, change,changes or deletedeletes anya DNS record.

 ⟨4 unchanged words⟩ :{"name":{"description":"Site name toas lookshown upby DNSlist_sites, recordse.g. for.my-portfolio. Provide name or siteId.","type":"string"},"siteId":{"description":"Site id to look upfrom DNSlist_sites recordsor for.get_site. ProvideUse nameinstead orof siteId.name.

 ⟨12 unchanged words⟩ records VibeDeploy tracks for this site, oldest first. Read-only — DNS changes are not made through this tool.","items":{"additionalProperties":false,"properties" ⟨70 unchanged words⟩ 

Return SHA-256 +and size forof every file currently served. Use BEFORE re-deploying to skip filesserved whosefile. contentBefore hasn'ta changed:redeploy, hash your local files, diff against this listcompare, and onlyupload shiponly the differenceschanged viaones with update_site mode:'patch' or begin_deploy →plus add_files. For SPAs with content-hashed bundle names this typically reduces a full-site redeploy to a handful of files.

 ⟨4 unchanged words⟩ :{"name":{"description":"Site name oras customshown domain.by Samelist_sites, lookupe.g. rulesmy-portfolio. asProvide get_site.name or siteId.","type":"string"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"}},"type":"object"}

Return the mostsite's recentlast 50 deploy and snapshot history entries for a site, newest first. Includes the sourcefirst: (how iteach was triggered), an optional label, the associated Longhorn snapshot name (if any), the file count, and the number of secrets detected. Each entry's snapshot holds the content from BEFORE that entryentry. (restoringRestoring itis undoesdone by the entry).user Anyin teamthe memberVibeDeploy candashboard readwithin history.the plan's restore window; there is no restore tool.

{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"}},"type":"object"}

 ⟨53 unchanged words⟩ {"type":"null"}],"description":"Longhorn snapshotSnapshot taken immediatelyjust BEFORE this entry's change (pre-deploy, pre-promote, pre-restore), so restoring it brings back the content thatwhat was live before this entry, not this entry's own content.entry. For manual-snapshot and staging entries it is the live content at that moment. To bring backget thean contentolder ofdeploy's anown oldercontent deployback, use the snapshot of the next newer entry. Null if none was taken or it was pruned

List the team's sites (name, URL, status, last deploy), most recently updated first, up to 100. Use list_sites to find a site name; use get_site for theone teamsite's thisfiles, connectionsource belongsstatus to.and history.

 ⟨4 unchanged words⟩ {"includeDeleted":{"description":"If true, includealso list soft-deleted sites still ininside their plan-specificplan's recoveryrestore window (status: 'deleted'). Defaults to false: deleted sites can't accept deploys, so an agent rarely wants them in a working list. Use true when you specifically need the recoveryDefault view.false.","type":"boolean"}},"type":"object"}

List the Longhorn volume snapshots forof a site.site's Snapshotsserved arefiles (point-in-time backupsrestore ofpoints). theNO_VOLUME site'smeans servedthe files.site Anywas teamnever memberdeployed. canRestoring lista snapshots.snapshot Returnsis NO_VOLUMEdone ifby the siteuser hasin nothe volumeVibeDeploy yetdashboard (itwithin hasthe neverplan's beenrestore deployed).window.

{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"}},"type":"object"}

ReturnList path, SHA-256 +and size forof every file in the site's editable source tree (the platform's copy of thestored pre-build code, not the served distfiles). Use BEFORE editing so you know which paths exist andRead-only. whichA haven'tsite changedwithout sincea thesource lasttree build.returns autoPromoteSOURCE_NOT_STORED:true will mirrorwrite the served dist into source for static-only sites whose source treewith iswrite_source_files, emptyor (doescopy nothingplain ifstatic theserved distfiles lookswith built).promote_dist_to_source.

 ⟨3 unchanged words⟩ ,"properties":{"autoPromote":{"description":"If trueDeprecated and the site has no source tree yet but its dist looks static, copy dist → sourceignored. onUse thepromote_dist_to_source fly.with Default:mode false.'auto'.","type":"boolean"},"forcePromote":{"description":"If true, mirror dist → source EVEN when dist looks built (e.g. minified Vite output). Use when the original source isn't recoverableDeprecated and you're willing to edit the build artefact directly. Sets manifest.noBuild=true automatically when noignored. package.jsonUse ispromote_dist_to_source inwith the

{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"autoPromoted":{"description":"Set to true when this call ran the auto-promote (dist → source) before listing. Lets the caller learn the source tree was just synthesised from the served dist.","type":"boolean"},"files":{"items":{"additionalProperties":false," ⟨14 unchanged words⟩ ,"type":"object"},"type":"array"},"hint":{"description":"Set when the deprecated autoPromote or forcePromote flag was passed.","type":"string"},"name":{"type":"string"} ⟨17 unchanged words⟩ 

Return the bytes of one file currently served by the site. Use this to inspectsite orserves editnow, existingas contenttext (callutf8) read_fileor →base64 modifyfor →binary update_sitefiles, mode:'patch')e.g. soto aedit newit chatand cansend iterateit onback awith siteupdate_site withoutmode:'patch'. re-uploading.Use Filesread_file largerfor thanthe 5242880served bytesfiles; can'tuse beread_source_file readinstead infor onethe call.editable Usesource listtree of(get_site.sourceStored). pathsMax from5242880 get_site.filePathsbytes; toget_site.filePaths discoverlists what'sthe available.paths.

 ⟨4 unchanged words⟩ :{"maxBytes":{"description":"Per-file size cap.cap in bytes. Default 1048576, hard max 5242880. If the file isA larger, the callfile fails with FILE_TOO_LARGE ratherinstead thanof returning truncated bytes — splitting source mid-token would corrupt downstream edits.bytes.","exclusiveMinimum":0,"maximum":5242880,"type":"integer"},"name":{"description":"Site name (subdomain)as orshown customby domain.list_sites, Samee.g. lookup

 ⟨8 unchanged words⟩ :"string"},"encoding":{"description":"How to interpret `content`. utf8 means the file is text and: `content` is the raw text. base64 means: the file is binary (image/font/etc.image, font, ...) and `content` is base64 —base64; decode before use.","enum":["utf8" ⟨46 unchanged words⟩ 

Batched version of read_file. PassRead up to 50 paths;served eachfiles isin fetchedone independentlycall, with the same per-file rules as read_file. The whole batch is cappedread_file atand 8388608 bytes total —in oncetotal; that'spaths exhausted,past remainingthe pathsbudget fail with BATCH_BUDGET_EXCEEDED, so the agent can re-requestrequest them again in another call. Use read_source_files instead for the editable source tree.

 ⟨3 unchanged words⟩ properties":{"maxBytesPerFile":{"description":"Per-file cap.size cap in bytes. Default 1048576, hard max 5242880.","exclusiveMinimum":0,"maximum":5242880,"type":"integer"},"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"paths":{"description" ⟨18 unchanged words⟩ 1,"type":"array"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"}},"required":[" ⟨3 unchanged words⟩ 

 ⟨34 unchanged words⟩ ":"One entry per requested path, in the same order. Each entry is independent: aA missing file or oversized file fails only its own entry but does not abort the wholeentry; batch.entries Ifpast the cumulative byte budget is exhausted partway through, remaining entries fail with code BATCH_BUDGET_EXCEEDED.","items":{"anyOf":[{" ⟨97 unchanged words⟩ 

Return the bytes of one source file (from the platform'ssite's editable copysource oftree (the stored pre-build code), letting an AI inso any future chat fetch andcan edit contentthe withoutsite needingwithout the original local files. Use list_source_files first toshows discoverthe paths. ForUse theread_source_file servedfor dist,source; use read_file instead.instead for the files the site serves.

 ⟨4 unchanged words⟩ :{"maxBytes":{"description":"Per-file size cap.cap in bytes. Default 1048576, hard max 5242880.","exclusiveMinimum":0,"maximum":5242880,"type":"integer"},"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"path":{"description":"Site-relative pathPath inside the source tree, e.g. 'src/App.tsx'.","type":"string"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"}},"required":[" ⟨3 unchanged words⟩ 

BatchedRead readup acrossto 50 files from the editable source tree in one call (up8388608 tobytes 50in pathstotal). Each entrypath issucceeds independent:or afails missing/oversizedon fileits failsown; itspaths ownpast slotthe butbudget doesn'tfail abortwith theBATCH_BUDGET_EXCEEDED. batch.Use Cumulativeread_source_files capfor 8388608source; bytes;use remainderread_files failsinstead withfor BATCH_BUDGET_EXCEEDED.the files the site serves.

{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"maxBytesPerFile":{"description":"Per-file size cap in bytes. Default 1048576, max 5242880.","exclusiveMinimum":0,"maximum":5242880,"type":"integer"},"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"paths":{"description":"Paths inside the source tree, e.g. 'src/App.tsx' (1 to 50). Results keep this order.","items":{"type":"string"},"maxItems":50,"minItems":1,"type":"array"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"}},"required":[" ⟨3 unchanged words⟩ 

 ⟨70 unchanged words⟩  applied atomically (patch mode). Images already hosted on vibedeploy.bea VibeDeploy platform domain are skipped.

 ⟨4 unchanged words⟩ :{"name":{"description":"Site name (subdomain)as shown by list_sites, whose external images should beare downloaded and rehostedstored locally.on the site.","type":"string"}},"required": ⟨3 unchanged words⟩ 

StopsStop every container service andof servesthe site; the site'ssite serves its static files again. Volumes (database data) are kept unless deleteData is true, which isdeletes irreversible.them for good. Use remove_app to stop only the containers; use delete_site to remove the whole site.

 ⟨18 unchanged words⟩ ,"type":"boolean"},"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"siteId":{"description":"Site id from list_sites or get_site. Use instead of name.","type":"string"}},"type":"object"}

RemoveDetach a custom domain from a site. The site itself is unaffected;unaffected onlyand thekeeps customserving hostnameon isits detached.platform Thesubdomain (e.g. {name}.vibedeploy.be subdomain keeps serving the site.).

 ⟨5 unchanged words⟩ :{"description":"The custom domain to remove, (e.g. 'tester.subsite.site').'shop.example.com'. Provide this ORor recordId.","type":"string"},"recordId":{"description":"The recordId returned by add_custom_domain.add_custom_domain or list_custom_domains. Provide this ORor domain.","type":"string"},"siteName" ⟨14 unchanged words⟩ 

Search every file of a site for a literal string or basic regex across all filesa inregular eitherexpression: the served distfiles by default, or the editable source tree. Use this BEFORE batch-reading files to find candidates — saves the 'readtree 14with batchestarget just'source'. toUse findit whichbefore 3reading files matter' round trip. Pass `target:in "source"`bulk, to searchfind the editable treeones (requiresthat Site.sourceStored=true).matter.

 ⟨3 unchanged words⟩ ,"properties":{"caseInsensitive":{"description":"Default: false. When true,Ignore addsupper/lower -icase. toDefault grep.false.","type":"boolean"},"glob":{"description":"FilenameFile globname filter, e.g. '*.js' or '*.{js,html}'. Applied via find before grep so we don't read non-matching files.","type":"string"},"maxMatches":{ ⟨19 unchanged words⟩ ,"type":"integer"},"name":{"description":"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId.","type":"string"},"pattern":{"description":"PatternText to search for. Treated literal by default; passfind regex:true(ASCII, tomax

 ⟨51 unchanged words⟩ ,"type":"string"},"enabled":{"description":"Send the confirmation email.","type":"boolean"},"message":{"description":"Text of the confirmation email.","maxLength":2000,"type":"string"},"subject":{"description":"Subject of the confirmation email.","maxLength":200,"type":"string"}}," ⟨55 unchanged words⟩ string"},{"properties":{"field":{"description":"Form field that holds the Reply-To address.","maxLength":100,"type":"string"}}," ⟨16 unchanged words⟩ \"<formField>\" }."},"requiredFields":{"description":"Form fields that must be filled in.","items":{"maxLength":100,"type":"string ⟨10 unchanged words⟩ email":{"description":"From address, e.g. support@serso.be. Onlysupport@example.com. honoredUsed once its domain is verified (verify_forms_sender_domain) ORor an smtpRelay is set; otherwise mailuntil fallsthen backmail touses the platform address.","type":"string"},"name":{"description":"Display name, e.g. \"Serso ServiceAcme Portal\Support\".","maxLength":100,"type":"string ⟨16 unchanged words⟩  Your server then owns SPF/DKIM. Recipients stay server-side, —so this is not an open relay.","properties ⟨70 unchanged words⟩ "none\" = plaintext, \"starttls\" = upgradeSTARTTLS on a plain connection, \"tls\" = implicit TLS.","enum ⟨19 unchanged words⟩ ,"type":"object"},"subject":{"description":"Subject of the lead email.","maxLength":200,"type":"string"},"template ⟨63 unchanged words⟩ ,"type":"array"},"footerText":{"description":"Text below the submitted fields.","maxLength":2000,"type":"string"},"headerText":{"description":"Text above the submitted fields.","maxLength":2000,"type":"string"}," ⟨60 unchanged words⟩ 

Apply one or more literal find/replace edits to a singleone file on the site, in one tool call. Designedcall, for tinysmall editschanges where uploading the fullwhole file would be wasteful (one nav-button reference, one encoding fix, one env varis bump).wasteful. Each edit must specifystates how many matches it expects; mismatchesany abortmismatch theaborts wholethe call with NOno writes. ForServed-file (dist) edits the change goesgo live immediately;at foronce; source edits youship stillwith needbuild_and_deploy. toUse callapply_edits build_and_deploy.for several files.

 ⟨3 unchanged words⟩ properties":{"edits":{"description":"Ordered list of edits to apply atomically. Each is `{find, replace, count?}`.`, Ifapplied anytogether; edit'sif any match count doesn't equal its expected countdiffers, the whole call aborts withnothing nois writes.written.","items":{"properties":{"count":{"description":"Expected number of matches.matches: Defaultdefault 1 (failfails ifon

Patch or replaceChange files on an existing site. DefaultsDefault tomode patch'patch' mode:writes only the listed files change; everything else stays. Pass mode:'replace' to wipe-and-replace the wholeand sitekeeps (the legacy behaviour, surfaced explicitly so it can't happen by accident). Userest; `delete: [paths]` inremoves patchfiles. mode:'replace' todeletes removeevery specificfile filesnot withoutlisted. wipingPreview thewith rest.dryRun:true. Use `dryRun:deploy_site true`instead to preview the diff beforecreate committing.a LARGEnew FILES:site. aA 100-250 KB text file fits in one call with encoding:'gzip+base64' (gzip locally, base64 thethen resultbase64) —; prefer that over begin_deploy +plus add_file_chunkadd_file_chunk. streaming.Fails Errorswith ifSITE_NOT_FOUND when the site does not exist.

 ⟨3 unchanged words⟩ ,"properties":{"delete":{"description":"Patch-modePatch mode only: site-relative paths to remove from the pod. Files not in this list are kept. Reported back in `deletedFiles` listing only entriesremove; thatother actuallyfiles existed.stay. Combine with `files` to atomically rename in one call (write new path + delete old path).call. Rejected in mode:'replace' since replace already removes anything not in `files`.mode.","items":{"type":"string"},"type":"array"},"dryRun":{"description":"If true, validate input + introspect what would change but don't write or delete. Returns the same shapeValidate withand `dryRun:preview true`

 ⟨30 unchanged words⟩ :"null"}],"description":"Result of the Netlify-style _headers sync: shipsyncing athe _headers file in the site root to override(site-wide default/* response headers (e.g. Permissions-Policy). Site-wide (/*) rules only."},"deletedFiles":{"description":"Files removed by this call. For patch mode this iscall: the entries from `delete` that actually existed;entries forthat replaceexisted mode(patch), it'sor every pre-existing file not in `files`.`files` (replace).

Check the TXT record the user added at stepfrom 1add_custom_domain and, ifwhen found,it attachis thefound, domainstart toserving the site's ingress. If verification fails,site theon mostthat commondomain cause(HTTPS is DNSissued propagationautomatically delay;within waitabout a30 fews). minutesIf andit tryfails, again.DNS Oncehas verified,usually thenot domainpropagated servesyet: thewait sitea immediatelyfew (HTTPSminutes issuesand automaticallycall withinit ~30s).again.

 ⟨46 unchanged words⟩ address. DNS can take a few minutes to propagate —propagate; re-run if it fails the first time. Not ⟨8 unchanged words⟩ 

StageWrite editsor tooverwrite afiles in the site's editable source tree (not the live dist). Use list_source_files first to discoverwrite what'screates there.it). The dist is unchanged until youserved re-deployfiles viado update_sitenot orchange rununtil build_and_deploy.build_and_deploy Sitesruns. haveUse sourcelist_source_files storagefirst enabledto bysee default;what ifexists. aA legacy site doesn't, the callwithout failssource withstorage SOURCE_STORAGE_NOT_ENABLEDreturns andSOURCE_STORAGE_NOT_ENABLED; the user shouldcan contactask VibeDeploy support to enable it.

 ⟨38 unchanged words⟩ "items":{"properties":{"content":{"description":"File content: text, or base64 as set by encoding.","type":"string"},"encoding":{"description":"utf8 (default) for plain text., base64 for (binary files. gzip+base64 for text files where you want to fit ~3x more bytes per), toolor call:gzip+base64 (gzip the raw bytes firstlocally, then base64-encode. Server gunzips before writing. Useful for shipping bigger source filesbase64; whenfits you'reabout hitting3x themore per-call

 ⟨9 unchanged words⟩ waiting/crash reasons, volumes), the stored config, the names of the site secrets that are set (never values) with the dashboard link where the user adds them, and optionally the recent logs of one service.