Launches a Firecracker microVM with the supplied set of disks each mounted
at its own relative path under /mnt/archil, runs the command to
completion, and shuts down the microVM. Activation is atomic: every disk mounts
or none of them do.
Relative paths must be non-empty, non-absolute, and contain no . /
.. segments. Mounting two disks at the same relative path is an
error.
Map of relative path under /mnt/archil to the disk to mount
there. At least one entry is required. Relative paths must be
non-empty, non-absolute, and contain no . or .. segments.
Each value is either a plain disk ID string (mounts the disk's
root, read-write) or an object that additionally selects a
subdirectory of the disk and/or marks the mount as read-only.
{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Archil","colors":{"primary":"#CA5550","light":"#CA5550","dark":"#CA5550"},"logo":{"light":"https://mintcdn.com/regattastorage/ZgodyIZMQ_rX_qud/logo/archil-black-fullbleed.svg?fit=max\u0026auto=format\u0026n=ZgodyIZMQ_rX_qud\u0026q=85\u0026s=adba0f4983e37336b24452e3ba977724","dark":"https://mintcdn.com/regattastorage/ZgodyIZMQ_rX_qud/logo/archil-white-fullbleed.svg?fit=max\u0026auto=format\u0026n=ZgodyIZMQ_rX_qud\u0026q=85\u0026s=3ba1c87384e113275374ebfbf55242a6","href":"https://archil.com"},"favicon":"https://mintcdn.com/regattastorage/S4_bUvKoVTjJKy3L/favicon.svg?fit=max\u0026auto=format\u0026n=S4_bUvKoVTjJKy3L\u0026q=85\u0026s=e2efc998ca3afaa27ef4036837d37349","background":{"color":{"dark":"#101011"}},"navbar":{"links":[{"href":"https://archil.com/pricing","label":"Pricing"},{"href":"mailto:support@archil.com","label":"Support"}],"primary":{"type":"button","label":"Console","href":"https://console.archil.com"}},"footer":{"socials":{"x":"https://x.com/archildata","linkedin":"https://linkedin.com/company/archil","discord":"https://discord.gg/KbXgvpWw7K"}},"seo":{"metatags":{"msvalidate.01":"EF0D87C55567AF7517BCE660F6318971"}},"integrations":{"posthog":{"apiKey":"phc_f4bRADnjXK5UboJFFUq9DIYClzzCl11Z4sdR5EM2UHE"}},"contextual":{"options":["copy","view","assistant","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"regattastorage","hasAudioNarration":false,"actualSubdomain":"regattastorage","customDomains":["docs.archil.com"],"gitSource":{"type":"github","owner":"archil-data","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adfd2f04b4632d676338d32","collectionId":"0c8b76ac-74af-4bc2-ae69-5e8538f71aea","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adfd2f04b4632d676338d32"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adfd2f04b4632d676338d32","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Documentation","count":46},{"language":"default","tag":"API Reference","count":39},{"language":"default","tag":"Guides","count":23},{"language":"default","tag":"Sandboxes","count":22},{"language":"default","tag":"Reference","count":16},{"language":"default","tag":"Use Archil on other platforms","count":10},{"language":"default","tag":"Details","count":8},{"language":"default","tag":"Agents","count":7},{"language":"default","tag":"Compute","count":6},{"language":"default","tag":"Disks","count":5}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@archil.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":".dark #navbar div.dark\\:bg-gray-900{background-color:#1a1a1c}"}],"page":{"pagePath":"api-reference/serverless-execution/exec-multi","slug":"/api-reference/serverless-execution/exec-multi","pageMetadata":{"title":"Execute Command with Multiple Disks","openapi":"POST /api/exec","description":"Launches a Firecracker microVM with the supplied set of disks each mounted\nat its own relative path under `/mnt/archil`, runs the command to\ncompletion, and shuts down the microVM. Activation is atomic: every disk mounts\nor none of them do.\n\nRelative paths must be non-empty, non-absolute, and contain no `.` /\n`..` segments. Mounting two disks at the same relative path is an\nerror.\n","href":"/api-reference/serverless-execution/exec-multi"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Launches a Firecracker microVM with the supplied set of disks each mounted\\nat its own relative path under \", _jsx(_components.code, {\n children: \"/mnt/archil\"\n }), \", runs the command to\\ncompletion, and shuts down the microVM. Activation is atomic: every disk mounts\\nor none of them do.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Relative paths must be non-empty, non-absolute, and contain no \", _jsx(_components.code, {\n children: \".\"\n }), \" /\\n\", _jsx(_components.code, {\n children: \"..\"\n }), \" segments. Mounting two disks at the same relative path is an\\nerror.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Execute Command with Multiple Disks","openapi":"POST /api/exec","description":"Launches a Firecracker microVM with the supplied set of disks each mounted\nat its own relative path under `/mnt/archil`, runs the command to\ncompletion, and shuts down the microVM. Activation is atomic: every disk mounts\nor none of them do.\n\nRelative paths must be non-empty, non-absolute, and contain no `.` /\n`..` segments. Mounting two disks at the same relative path is an\nerror.\n","href":"/api-reference/serverless-execution/exec-multi"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"exec","summary":"Execute a command with multiple disks mounted","description":"Launches a Firecracker microVM with the supplied set of disks each mounted\nat its own relative path under `/mnt/archil`, runs the command to\ncompletion, and shuts down the microVM. Activation is atomic: every disk mounts\nor none of them do.\n\nRelative paths must be non-empty, non-absolute, and contain no `.` /\n`..` segments. Mounting two disks at the same relative path is an\nerror.\n","tags":["Serverless Execution"],"requestBody":"be57d29a-b411-40ff-adce-69c6964c983d","responses":{"200":"ed3420ac-d791-4325-b944-cad5890557ff","400":"d7980c54-0b92-44cd-8ec5-96e5f72f51a2","401":"b582de8c-e490-4a82-a260-8eab7258681d","404":"05fbed0e-dfd7-462f-930c-c9be0bf1da21","500":"09b5064b-5c29-4850-aa28-c212e7c8a272","504":"cacee226-1a56-43e2-9899-17d7f0062078"},"method":"post","type":"path","servers":["a2316700-ac4a-477f-92cc-9347a2d2c752","85c292f6-d149-412e-b9d9-bdef734b92cf","3a76ee25-c863-4e6b-a84c-56e33e827052","e2948792-c76f-4332-9de0-6676a816a823"],"security":["643381de-01e7-4fc5-abec-369592499f16"],"path":"/api/exec","baseUrlOptions":["https://control.green.us-east-1.aws.prod.archil.com","https://control.green.eu-west-1.aws.prod.archil.com","https://control.green.us-west-2.aws.prod.archil.com","https://control.blue.us-central1.gcp.prod.archil.com"],"title":"Execute a command with multiple disks mounted","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["disks","command"],"properties":{"disks":{"type":"object","description":"Map of relative path under `/mnt/archil` to the disk to mount\nthere. At least one entry is required. Relative paths must be\nnon-empty, non-absolute, and contain no `.` or `..` segments.\n\nEach value is either a plain disk ID string (mounts the disk's\nroot, read-write) or an object that additionally selects a\nsubdirectory of the disk and/or marks the mount as read-only.\n","additionalProperties":{"oneOf":[{"type":"string","description":"Disk ID; mounts the disk's root as read-write","example":"dsk-abc123","uniqueKey":"disks.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"object","required":["disk"],"properties":{"disk":{"type":"string","description":"Disk ID to mount at this relative path","example":"dsk-abc123","isRequired":true,"uniqueKey":"disks.additionalProperties.oneOf.1.disk","typeLabel":"string"},"subdirectory":{"type":"string","description":"Subdirectory of the disk to expose at the mountpoint. Must be a\nrelative path with no `.` or `..` segments. When omitted, the\ndisk's root is exposed.\n","example":"app/logs","uniqueKey":"disks.additionalProperties.oneOf.1.subdirectory","typeLabel":"string"},"readOnly":{"type":"boolean","default":false,"description":"When true, the disk is mounted read-only inside the microVM.\nWrites against the mount fail with EROFS.\n","uniqueKey":"disks.additionalProperties.oneOf.1.readOnly","typeLabel":"boolean"}},"uniqueKey":"disks.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"disks.additionalProperties","typeLabel":"string | object"},"example":{"data":"dsk-abc123","logs":{"disk":"dsk-def456","subdirectory":"app/logs","readOnly":true}},"isRequired":true,"uniqueKey":"disks","typeLabel":"object"},"command":{"type":"string","description":"Shell command to execute inside the microVM","example":"ls -la /mnt/archil/data /mnt/archil/logs","isRequired":true,"uniqueKey":"command","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"disks":{"data":"dsk-abc123","logs":{"disk":"dsk-def456","subdirectory":"app/logs","readOnly":true}},"command":"ls -la /mnt/archil/data /mnt/archil/logs"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ed3420ac-d791-4325-b944-cad5890557ff":{"description":"Command completed","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","required":["exitCode","stdout","stderr","timing"],"properties":{"exitCode":{"type":"integer","description":"Exit code of the command (0 = success)","example":0,"isRequired":true,"uniqueKey":"data.exitCode","typeLabel":"integer"},"stdout":{"type":"string","description":"Standard output from the command","isRequired":true,"uniqueKey":"data.stdout","typeLabel":"string"},"stderr":{"type":"string","description":"Standard error from the command","isRequired":true,"uniqueKey":"data.stderr","typeLabel":"string"},"timing":{"type":"object","description":"Server-measured timings for an exec request.","required":["totalMs","queueMs","executeMs"],"properties":{"totalMs":{"type":"integer","description":"End-to-end wall clock measured on the server, from request arrival to response.\n","example":2450,"isRequired":true,"uniqueKey":"data.timing.totalMs","typeLabel":"integer"},"queueMs":{"type":"integer","description":"Time spent queueing, scheduling, booting/claiming a VM, and mounting the filesystem before the command started running.\n","example":150,"isRequired":true,"uniqueKey":"data.timing.queueMs","typeLabel":"integer"},"executeMs":{"type":"integer","description":"Time the user's command itself ran, measured by the runtime.\n","example":2300,"isRequired":true,"uniqueKey":"data.timing.executeMs","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"data.timing","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"exitCode":0,"stdout":"\u003cstring>","stderr":"\u003cstring>","timing":{"totalMs":2450,"queueMs":150,"executeMs":2300}}}}},"exampleType":"generated"}},"exampleType":"generated"},"d7980c54-0b92-44cd-8ec5-96e5f72f51a2":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Invalid request parameters","code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"b582de8c-e490-4a82-a260-8eab7258681d":{"description":"Invalid or missing authentication credentials","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Invalid request parameters","code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"05fbed0e-dfd7-462f-930c-c9be0bf1da21":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Invalid request parameters","code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"09b5064b-5c29-4850-aa28-c212e7c8a272":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Invalid request parameters","code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"cacee226-1a56-43e2-9899-17d7f0062078":{"description":"Command timed out","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Invalid request parameters","code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"643381de-01e7-4fc5-abec-369592499f16":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"Archil API key, including its `key-` prefix","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"a2316700-ac4a-477f-92cc-9347a2d2c752":{"url":"https://control.green.us-east-1.aws.prod.archil.com","description":"AWS US East (N. Virginia) — aws-us-east-1"},"85c292f6-d149-412e-b9d9-bdef734b92cf":{"url":"https://control.green.eu-west-1.aws.prod.archil.com","description":"AWS EU West (Ireland) — aws-eu-west-1"},"3a76ee25-c863-4e6b-a84c-56e33e827052":{"url":"https://control.green.us-west-2.aws.prod.archil.com","description":"AWS US West (Oregon) — aws-us-west-2"},"e2948792-c76f-4332-9de0-6676a816a823":{"url":"https://control.blue.us-central1.gcp.prod.archil.com","description":"GCP US Central (Iowa) — gcp-us-central1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Archil API key, including its `key-` prefix","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Archil API key, including its `key-` prefix","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"regattastorage","siteName":"Archil","title":"Execute Command with Multiple Disks - Archil","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T15:16:17.381Z","originalFileLocation":"api-reference/serverless-execution/exec-multi.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Launches a Firecracker microVM with the supplied set of disks each mounted at its own relative path under /mnt/archil, runs the command to completion, and shuts down the microVM. Activation is atomic: every disk mounts or none of them do. Relative paths must be non-empty, non-absolute, and contain no . / .. segments. Mounting two disks at the same relative path is an error.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Archil\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Execute Command with Multiple Disks - Archil\">\u003cmeta data-mint-head property=\"og:description\" content=\"Launches a Firecracker microVM with the supplied set of disks each mounted at its own relative path under /mnt/archil, runs the command to completion, and shuts down the microVM. Activation is atomic: every disk mounts or none of them do. Relative paths must be non-empty, non-absolute, and contain no . / .. segments. Mounting two disks at the same relative path is an error.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Archil\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.archil.com/api-reference/serverless-execution/exec-multi\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://regattastorage.mintlify.app/_mintlify/api/og/v2?division=Serverless+Execution\u0026amp;title=Execute+Command+with+Multiple+Disks\u0026amp;description=Launches+a+Firecracker+microVM+with+the+supplied+set+of+disks+each+mounted%0Aat+its+own+relative+path+under+%60%2Fmnt%2Farchil%60%2C+runs+the+command+to%0Acompletion%2C+and+shu\u0026amp;theme=769a6d2c91fa13ef59890af3\u0026amp;signature=c7ec0130c5f39b90a5d2fcac1d780cb30edf1305957559b93baa8b467e9689ee\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Execute Command with Multiple Disks - Archil\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Launches a Firecracker microVM with the supplied set of disks each mounted at its own relative path under /mnt/archil, runs the command to completion, and shuts down the microVM. Activation is atomic: every disk mounts or none of them do. Relative paths must be non-empty, non-absolute, and contain no . / .. segments. Mounting two disks at the same relative path is an error.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://regattastorage.mintlify.app/_mintlify/api/og/v2?division=Serverless+Execution\u0026amp;title=Execute+Command+with+Multiple+Disks\u0026amp;description=Launches+a+Firecracker+microVM+with+the+supplied+set+of+disks+each+mounted%0Aat+its+own+relative+path+under+%60%2Fmnt%2Farchil%60%2C+runs+the+command+to%0Acompletion%2C+and+shu\u0026amp;theme=769a6d2c91fa13ef59890af3\u0026amp;signature=c7ec0130c5f39b90a5d2fcac1d780cb30edf1305957559b93baa8b467e9689ee\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Archil\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#CA5550\">\u003cmeta data-mint-head name=\"msvalidate.01\" content=\"EF0D87C55567AF7517BCE660F6318971\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.archil.com/api-reference/serverless-execution/exec-multi\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/serverless-execution/exec-multi.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.archil.com/#organization\",\"name\":\"Archil\",\"url\":\"https://docs.archil.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/regattastorage/ZgodyIZMQ_rX_qud/logo/archil-black-fullbleed.svg?fit=max\u0026auto=format\u0026n=ZgodyIZMQ_rX_qud\u0026q=85\u0026s=adba0f4983e37336b24452e3ba977724\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.archil.com#website\",\"name\":\"Archil\",\"url\":\"https://docs.archil.com\",\"publisher\":{\"@id\":\"https://docs.archil.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.archil.com/api-reference/serverless-execution/exec-multi#webpage\",\"url\":\"https://docs.archil.com/api-reference/serverless-execution/exec-multi\",\"name\":\"Execute Command with Multiple Disks\",\"description\":\"Launches a Firecracker microVM with the supplied set of disks each mounted at its own relative path under /mnt/archil, runs the command to completion, and shuts down the microVM. Activation is atomic: every disk mounts or none of them do. Relative paths must be non-empty, non-absolute, and contain no . / .. segments. Mounting two disks at the same relative path is an error.\",\"dateModified\":\"2026-10-22T15:16:17.381Z\",\"isPartOf\":{\"@id\":\"https://docs.archil.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.archil.com/api-reference/serverless-execution/exec-multi#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.archil.com/api-reference/serverless-execution/exec-multi#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Serverless Execution\",\"item\":\"https://docs.archil.com/api-reference/serverless-execution/exec-disk\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Execute Command with Multiple Disks\",\"item\":\"https://docs.archil.com/api-reference/serverless-execution/exec-multi\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.archil.com/api-reference/serverless-execution/exec-multi#apireference\",\"headline\":\"Execute Command with Multiple Disks\",\"name\":\"Execute Command with Multiple Disks\",\"description\":\"Launches a Firecracker microVM with the supplied set of disks each mounted at its own relative path under /mnt/archil, runs the command to completion, and shuts down the microVM. Activation is atomic: every disk mounts or none of them do. Relative paths must be non-empty, non-absolute, and contain no . / .. segments. Mounting two disks at the same relative path is an error.\",\"url\":\"https://docs.archil.com/api-reference/serverless-execution/exec-multi\",\"mainEntityOfPage\":{\"@id\":\"https://docs.archil.com/api-reference/serverless-execution/exec-multi#webpage\"},\"dateModified\":\"2026-10-22T15:16:17.381Z\",\"publisher\":{\"@id\":\"https://docs.archil.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.archil.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Archil\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Archil","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/getting-started/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Disks","pages":[{"title":"List Disks","openapi":"GET /api/disks","href":"/api-reference/disks/list-disks"},{"title":"Create Disk","openapi":"POST /api/disks","href":"/api-reference/disks/create-disk"},{"title":"Get Disk","openapi":"GET /api/disks/{id}","href":"/api-reference/disks/get-disk"},{"title":"Delete Disk","openapi":"DELETE /api/disks/{id}","href":"/api-reference/disks/delete-disk"},{"title":"Create Share URL","openapi":"POST /api/disks/{id}/share","href":"/api-reference/disks/create-share-url"}]},{"group":"Serverless Execution","pages":[{"title":"Execute Command on Disk","openapi":"POST /api/disks/{id}/exec","description":"Launches a Firecracker microVM with the specified disk mounted, runs the\ngiven command to completion, shuts down the microVM, and returns the\ncommand result.\n","href":"/api-reference/serverless-execution/exec-disk"},{"title":"Execute Command with Multiple Disks","openapi":"POST /api/exec","href":"/api-reference/serverless-execution/exec-multi"},{"title":"Search Files (grep)","sidebarTitle":"Search Files","openapi":"POST /api/disks/{id}/grep","description":"Searches files under a directory on the disk for lines matching a\nregular expression. Listing and matching are fanned out across\nephemeral exec microVMs, so the request finishes within the user's\ntime budget regardless of the size of the directory.\n\nThe user controls search latency and scope with three knobs:\n\n- `maxDurationSeconds` is the wall-clock deadline (capped at 30s).\n- `concurrency` is the maximum number of parallel grep workers.\n Higher concurrency finishes larger datasets within the deadline,\n at proportionally more compute.\n- `maxResults` causes the search to short-circuit after the\n aggregator has collected this many matches.\n\nWith `recursive: false` only files directly under `directory` are\nsearched. With `recursive: true` subdirectories are walked\nbreadth-first and grep workers are dispatched as soon as each level\nfinishes listing — listing and matching overlap.\n\nThe matches returned when stopping early on `maxResults` are a sample\nof whichever workers reported first, not the lexicographically first\nN. The response surfaces `stoppedReason` so callers can distinguish\ncompletion from early termination.\n","href":"/api-reference/serverless-execution/grep-disk"}]},{"group":"Sandboxes","pages":[{"title":"List Sandboxes","openapi":"GET /api/sandboxes","href":"/api-reference/sandboxes/list-sandboxes"},{"title":"Create Sandbox","openapi":"POST /api/sandboxes","href":"/api-reference/sandboxes/create-sandbox"},{"title":"Get Sandbox","openapi":"GET /api/sandboxes/{sid}","href":"/api-reference/sandboxes/get-sandbox"},{"title":"Delete Sandbox","openapi":"DELETE /api/sandboxes/{sid}","href":"/api-reference/sandboxes/delete-sandbox"},{"title":"Create Sandbox Connection","openapi":"POST /api/sandboxes/{sid}/connections","href":"/api-reference/sandboxes/create-sandbox-connection"},{"title":"Set Sandbox Timeouts","openapi":"POST /api/sandboxes/{sid}/timeout","href":"/api-reference/sandboxes/set-sandbox-timeout"},{"title":"List Sandbox Ports","openapi":"GET /api/sandboxes/{sid}/ports","href":"/api-reference/sandboxes/list-sandbox-ports"},{"title":"Expose Sandbox Port","openapi":"PUT /api/sandboxes/{sid}/ports/{port}","href":"/api-reference/sandboxes/expose-sandbox-port"},{"title":"Unexpose Sandbox Port","openapi":"DELETE /api/sandboxes/{sid}/ports/{port}","href":"/api-reference/sandboxes/unexpose-sandbox-port"},{"title":"List Sandbox Port Tokens","openapi":"GET /api/sandboxes/{sid}/port-tokens","href":"/api-reference/sandboxes/list-sandbox-port-tokens"},{"title":"Create Sandbox Port Token","openapi":"POST /api/sandboxes/{sid}/port-tokens","href":"/api-reference/sandboxes/create-sandbox-port-token"},{"title":"Get Sandbox Port Token","openapi":"GET /api/sandboxes/{sid}/port-tokens/{token_id}","href":"/api-reference/sandboxes/get-sandbox-port-token"},{"title":"Delete Sandbox Port Token","openapi":"DELETE /api/sandboxes/{sid}/port-tokens/{token_id}","href":"/api-reference/sandboxes/delete-sandbox-port-token"},{"title":"Get Sandbox Network","openapi":"GET /api/sandboxes/{sid}/network","href":"/api-reference/sandboxes/get-sandbox-network"},{"title":"Update Sandbox Network","openapi":"PUT /api/sandboxes/{sid}/network","href":"/api-reference/sandboxes/update-sandbox-network"},{"title":"Pause Sandbox","openapi":"POST /api/sandboxes/{sid}/pause","href":"/api-reference/sandboxes/pause-sandbox"},{"title":"Fork Sandbox","openapi":"POST /api/sandboxes/{sid}/fork","href":"/api-reference/sandboxes/fork-sandbox"},{"title":"Resume Sandbox","openapi":"POST /api/sandboxes/{sid}/resume","href":"/api-reference/sandboxes/resume-sandbox"},{"title":"Start Sandbox","openapi":"POST /api/sandboxes/{sid}/start","href":"/api-reference/sandboxes/start-sandbox"},{"title":"Stop Sandbox","openapi":"POST /api/sandboxes/{sid}/stop","href":"/api-reference/sandboxes/stop-sandbox"},{"title":"Build Image","openapi":"POST /api/images","href":"/api-reference/images/build-image"},{"title":"Get Image","openapi":"GET /api/images/{image_id}","href":"/api-reference/images/get-image"}]},{"group":"Disk Users","pages":[{"title":"Add Disk User","openapi":"POST /api/disks/{id}/users","href":"/api-reference/disk-users/add-user"},{"title":"Remove Disk User","openapi":"DELETE /api/disks/{id}/users/{userType}","href":"/api-reference/disk-users/remove-user"}]},{"group":"API Tokens","pages":[{"title":"List API Tokens","openapi":"GET /api/tokens","href":"/api-reference/tokens/list-tokens"},{"title":"Create API Token","openapi":"POST /api/tokens","href":"/api-reference/tokens/create-token"},{"title":"Delete API Token","openapi":"DELETE /api/tokens/{id}","href":"/api-reference/tokens/delete-token"}]},{"group":"Billing","pages":[{"title":"Get Usage","openapi":"GET /api/billing/usage","href":"/api-reference/billing/get-usage"},{"title":"Get Costs","openapi":"GET /api/billing/costs","href":"/api-reference/billing/get-costs"},{"title":"Get Summary","openapi":"GET /api/billing/summary","href":"/api-reference/billing/get-summary"}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/agents/coding-agent"}]}]},"title":"Execute Command with Multiple Disks - Archil","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-D5fEM6aW.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}