Creates a new disk with the specified configuration. A default disk
token user is automatically generated and returned in the response,
so the disk is immediately mountable. The one-time disk token appears
in authorizedUsers[].token and cannot be retrieved again. (This
disk token is scoped to the new disk and is separate from the API
key you used to make this request.)
To provide your own users instead, pass the deprecated authMethods
field or call AddDiskUser after creation.
{"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":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b012bbebc9bec18ba0e4cc1","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":55},{"language":"default","tag":"API Reference","count":41},{"language":"default","tag":"Guides","count":30},{"language":"default","tag":"Reference","count":24},{"language":"default","tag":"Sandboxes","count":23},{"language":"default","tag":"Use Archil on other platforms","count":11},{"language":"default","tag":"Agents","count":9},{"language":"default","tag":"Details","count":8},{"language":"default","tag":"Disks","count":6},{"language":"default","tag":"Compute","count":6}]},"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":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"site-roles","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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":".dark #navbar div.dark\\:bg-gray-900{background-color:#1a1a1c}"}]}
{"page":{"pagePath":"api-reference/disks/create-disk","slug":"/api-reference/disks/create-disk","pageMetadata":{"title":"Create Disk","openapi":"POST /api/disks","description":"Creates a new disk with the specified configuration. A default disk\ntoken user is automatically generated and returned in the response,\nso the disk is immediately mountable. The one-time disk token appears\nin `authorizedUsers[].token` and cannot be retrieved again. (This\ndisk token is scoped to the new disk and is separate from the API\nkey you used to make this request.)\n\nTo provide your own users instead, pass the deprecated `authMethods`\nfield or call AddDiskUser after creation.\n","href":"/api-reference/disks/create-disk"},"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: [\"Creates a new disk with the specified configuration. A default disk\\ntoken user is automatically generated and returned in the response,\\nso the disk is immediately mountable. The one-time disk token appears\\nin \", _jsx(_components.code, {\n children: \"authorizedUsers[].token\"\n }), \" and cannot be retrieved again. (This\\ndisk token is scoped to the new disk and is separate from the API\\nkey you used to make this request.)\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"To provide your own users instead, pass the deprecated \", _jsx(_components.code, {\n children: \"authMethods\"\n }), \"\\nfield or call AddDiskUser after creation.\"]\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":"Create Disk","openapi":"POST /api/disks","description":"Creates a new disk with the specified configuration. A default disk\ntoken user is automatically generated and returned in the response,\nso the disk is immediately mountable. The one-time disk token appears\nin `authorizedUsers[].token` and cannot be retrieved again. (This\ndisk token is scoped to the new disk and is separate from the API\nkey you used to make this request.)\n\nTo provide your own users instead, pass the deprecated `authMethods`\nfield or call AddDiskUser after creation.\n","href":"/api-reference/disks/create-disk"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/regattastorage/7f4d365ae8e61637/rb2b.js"],"openApiReferenceData":{"operation":{"operationId":"createDisk","summary":"Create a new disk","description":"Creates a new disk with the specified configuration. A default disk\ntoken user is automatically generated and returned in the response,\nso the disk is immediately mountable. The one-time disk token appears\nin `authorizedUsers[].token` and cannot be retrieved again. (This\ndisk token is scoped to the new disk and is separate from the API\nkey you used to make this request.)\n\nTo provide your own users instead, pass the deprecated `authMethods`\nfield or call AddDiskUser after creation.\n","tags":["Disks"],"requestBody":"9b91685b-cdaf-4dd1-b73d-0d4eef2063f6","responses":{"200":"56f29f31-be84-4c08-861b-f21460651883","201":"c2b59f9a-4dda-437a-ada0-59b755c7ab90","400":"461c3c43-a4e6-4ad4-b2f2-b99bd0fad066","401":"0ebae9ac-7977-4819-a9ca-c5435bf0c7b8","403":"d79a7820-8bc0-4e55-a390-cad23e30d5f6","409":"078fd987-3349-47e4-8ea6-54363a276ae4","500":"b87b85ad-a70b-452d-ab5c-5f593dc240e0"},"method":"post","type":"path","servers":["b1342687-6cb8-4a7e-8bf7-37e1e6785396","ccc4eea5-2d5f-4c21-90b3-49f4e1a5c133","641e25ad-2e75-4766-9aee-dcccff02838a","6f0c44fb-45f8-42a1-b3f2-9c5e38dc6f60"],"security":["d4e1daaa-47eb-499e-9fff-d91128fbd239"],"path":"/api/disks","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":"Create a new disk","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Disk name (alphanumeric, dashes, underscores)","minLength":1,"maxLength":100,"pattern":"^[a-zA-Z0-9_-]+$","example":"my-data-disk","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"mounts":{"type":"array","description":"Storage mount to attach. Omit for archil-managed storage.","minItems":0,"maxItems":1,"items":{"oneOf":[{"type":"object","title":"S3","description":"Mount configuration for Amazon S3 buckets","required":["type","bucketName"],"properties":{"type":{"type":"string","enum":["s3"],"description":"Mount type identifier","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"bucketName":{"type":"string","description":"S3 bucket name","example":"my-bucket","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.0.bucketName","typeLabel":"string"},"accessKeyId":{"type":"string","description":"AWS access key ID (optional for public buckets or IAM role auth)","uniqueKey":"mounts.items.[INDEX].oneOf.0.accessKeyId","typeLabel":"string"},"secretAccessKey":{"type":"string","description":"AWS secret access key","format":"password","writeOnly":true,"uniqueKey":"mounts.items.[INDEX].oneOf.0.secretAccessKey","typeLabel":"string\u003cpassword>"},"sessionToken":{"type":"string","description":"Session token for temporary credentials","writeOnly":true,"uniqueKey":"mounts.items.[INDEX].oneOf.0.sessionToken","typeLabel":"string"},"bucketPrefix":{"type":"string","description":"Prefix within the bucket","example":"data/","uniqueKey":"mounts.items.[INDEX].oneOf.0.bucketPrefix","typeLabel":"string"}},"uniqueKey":"mounts.items.[INDEX].oneOf.0","typeLabel":"S3 · object"},{"type":"object","title":"Google Cloud Storage","description":"Mount configuration for Google Cloud Storage buckets","required":["type","bucketName","accessKeyId","secretAccessKey"],"properties":{"type":{"type":"string","enum":["gcs"],"description":"Mount type identifier","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"bucketName":{"type":"string","description":"GCS bucket name","example":"my-gcs-bucket","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.1.bucketName","typeLabel":"string"},"accessKeyId":{"type":"string","description":"HMAC access key ID","writeOnly":true,"isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.1.accessKeyId","typeLabel":"string"},"secretAccessKey":{"type":"string","description":"HMAC secret access key","format":"password","writeOnly":true,"isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.1.secretAccessKey","typeLabel":"string\u003cpassword>"},"bucketPrefix":{"type":"string","description":"Prefix within the bucket (optional)","example":"data/","uniqueKey":"mounts.items.[INDEX].oneOf.1.bucketPrefix","typeLabel":"string"}},"uniqueKey":"mounts.items.[INDEX].oneOf.1","typeLabel":"Google Cloud Storage · object"},{"type":"object","title":"Cloudflare R2","description":"Mount configuration for Cloudflare R2 buckets","required":["type","bucketName","bucketEndpoint","accessKeyId","secretAccessKey"],"properties":{"type":{"type":"string","enum":["r2"],"description":"Mount type identifier","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"bucketName":{"type":"string","description":"R2 bucket name","example":"my-r2-bucket","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.2.bucketName","typeLabel":"string"},"bucketEndpoint":{"type":"string","description":"R2 endpoint URL","example":"https://accountid.r2.cloudflarestorage.com","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.2.bucketEndpoint","typeLabel":"string"},"accessKeyId":{"type":"string","description":"R2 access key ID","writeOnly":true,"isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.2.accessKeyId","typeLabel":"string"},"secretAccessKey":{"type":"string","description":"R2 secret access key","format":"password","writeOnly":true,"isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.2.secretAccessKey","typeLabel":"string\u003cpassword>"},"bucketPrefix":{"type":"string","description":"Prefix within the bucket (optional)","example":"data/","uniqueKey":"mounts.items.[INDEX].oneOf.2.bucketPrefix","typeLabel":"string"}},"uniqueKey":"mounts.items.[INDEX].oneOf.2","typeLabel":"Cloudflare R2 · object"},{"type":"object","title":"S3-Compatible","description":"Mount configuration for S3-compatible storage (MinIO, Backblaze B2, etc.)","required":["type","bucketName","bucketEndpoint","accessKeyId","secretAccessKey"],"properties":{"type":{"type":"string","enum":["s3-compatible"],"description":"Mount type identifier","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"bucketName":{"type":"string","description":"Bucket name","example":"my-bucket","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.3.bucketName","typeLabel":"string"},"bucketEndpoint":{"type":"string","description":"S3-compatible endpoint URL","example":"https://s3.us-west-001.backblazeb2.com","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.3.bucketEndpoint","typeLabel":"string"},"accessKeyId":{"type":"string","description":"Access key ID","writeOnly":true,"isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.3.accessKeyId","typeLabel":"string"},"secretAccessKey":{"type":"string","description":"Secret access key","format":"password","writeOnly":true,"isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.3.secretAccessKey","typeLabel":"string\u003cpassword>"},"bucketPrefix":{"type":"string","description":"Prefix within the bucket (optional)","example":"data/","uniqueKey":"mounts.items.[INDEX].oneOf.3.bucketPrefix","typeLabel":"string"}},"uniqueKey":"mounts.items.[INDEX].oneOf.3","typeLabel":"S3-Compatible · object"},{"type":"object","title":"Azure Blob Storage","description":"Mount configuration for Azure Blob Storage containers","required":["type","containerName","tenantId","clientId","clientSecret"],"properties":{"type":{"type":"string","enum":["azure-blob"],"description":"Mount type identifier","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"containerName":{"type":"string","description":"Azure blob container name","example":"my-container","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.4.containerName","typeLabel":"string"},"tenantId":{"type":"string","description":"Azure AD tenant ID","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.4.tenantId","typeLabel":"string"},"clientId":{"type":"string","description":"Azure AD application client ID","isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.4.clientId","typeLabel":"string"},"clientSecret":{"type":"string","description":"Azure AD application client secret","format":"password","writeOnly":true,"isRequired":true,"uniqueKey":"mounts.items.[INDEX].oneOf.4.clientSecret","typeLabel":"string\u003cpassword>"},"endpoint":{"type":"string","description":"Azure blob endpoint URL (optional if storageAccountName provided)","example":"https://myaccount.blob.core.windows.net","uniqueKey":"mounts.items.[INDEX].oneOf.4.endpoint","typeLabel":"string"},"storageAccountName":{"type":"string","description":"Azure storage account name (used to derive endpoint if not provided)","example":"myaccount","uniqueKey":"mounts.items.[INDEX].oneOf.4.storageAccountName","typeLabel":"string"},"bucketPrefix":{"type":"string","description":"Prefix within the container","example":"data/","uniqueKey":"mounts.items.[INDEX].oneOf.4.bucketPrefix","typeLabel":"string"}},"uniqueKey":"mounts.items.[INDEX].oneOf.4","typeLabel":"Azure Blob Storage · object"}],"uniqueKey":"mounts.items.[INDEX]","typeLabel":"S3 · object | Google Cloud Storage · object | Cloudflare R2 · object | S3-Compatible · object | Azure Blob Storage · object"},"uniqueKey":"mounts","typeLabel":"(S3 · object | Google Cloud Storage · object | Cloudflare R2 · object | S3-Compatible · object | Azure Blob Storage · object)[]"},"authMethods":{"type":"array","deprecated":true,"description":"Deprecated. Use AddDiskUser after creation instead. When provided, suppresses the default auto-generated token user.\n","items":{"oneOf":[{"type":"object","required":["type","nickname"],"properties":{"type":{"type":"string","enum":["token"],"isRequired":true,"uniqueKey":"authMethods.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"nickname":{"type":"string","maxLength":255,"isRequired":true,"uniqueKey":"authMethods.items.[INDEX].oneOf.0.nickname","typeLabel":"string"},"principal":{"type":"string","maxLength":2048,"deprecated":true,"description":"Deprecated. Client-provided token. If omitted, the server generates a cryptographically secure token and returns it in the response.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.0.principal","typeLabel":"string"},"tokenSuffix":{"type":"string","minLength":4,"maxLength":4,"deprecated":true,"description":"Deprecated. Last 4 characters of the token. Required when principal is provided; ignored when the server generates the token.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.0.tokenSuffix","typeLabel":"string"},"ttl":{"type":"string","description":"Optional time-to-live as a Go duration string (e.g. \"1h\", \"30m\", \"24h\"). Maximum 365 days (\"8760h\"). Mutually exclusive with expiresAt.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.0.ttl","typeLabel":"string"},"expiresAt":{"type":"string","format":"date-time","description":"Optional absolute expiration time as an RFC3339 timestamp (e.g. \"2026-07-15T00:00:00Z\"). Must be in the future. Mutually exclusive with ttl.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.0.expiresAt","typeLabel":"string\u003cdate-time>"},"oneUse":{"type":"boolean","description":"When true, the token can be used for only one mount. Later mount attempts with it are rejected.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.0.oneUse","typeLabel":"boolean"},"readOnly":{"type":"boolean","description":"When true, mounts made with this token reject writes with EROFS.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.0.readOnly","typeLabel":"boolean"}},"uniqueKey":"authMethods.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","principal"],"properties":{"type":{"type":"string","enum":["awssts"],"isRequired":true,"uniqueKey":"authMethods.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"principal":{"type":"string","description":"IAM principal ARN","maxLength":2048,"isRequired":true,"uniqueKey":"authMethods.items.[INDEX].oneOf.1.principal","typeLabel":"string"},"ttl":{"type":"string","description":"Optional time-to-live as a Go duration string (e.g. \"1h\", \"30m\", \"24h\"). Maximum 365 days (\"8760h\"). Mutually exclusive with expiresAt.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.1.ttl","typeLabel":"string"},"expiresAt":{"type":"string","format":"date-time","description":"Optional absolute expiration time as an RFC3339 timestamp (e.g. \"2026-07-15T00:00:00Z\"). Must be in the future. Mutually exclusive with ttl.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.1.expiresAt","typeLabel":"string\u003cdate-time>"},"oneUse":{"type":"boolean","description":"When true, the credential can be used for only one mount.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.1.oneUse","typeLabel":"boolean"},"readOnly":{"type":"boolean","description":"When true, mounts made with this credential reject writes with EROFS.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.1.readOnly","typeLabel":"boolean"}},"uniqueKey":"authMethods.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["s3"],"isRequired":true,"uniqueKey":"authMethods.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"nickname":{"type":"string","maxLength":255,"uniqueKey":"authMethods.items.[INDEX].oneOf.2.nickname","typeLabel":"string"},"ttl":{"type":"string","description":"Optional time-to-live as a Go duration string (e.g. \"1h\", \"30m\"). Maximum 365 days (\"8760h\"). Requests signed with an expired key, including presigned URLs, are rejected. Mutually exclusive with expiresAt.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.2.ttl","typeLabel":"string"},"expiresAt":{"type":"string","format":"date-time","description":"Optional absolute expiration time as an RFC3339 timestamp. Must be in the future. Mutually exclusive with ttl.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.2.expiresAt","typeLabel":"string\u003cdate-time>"},"readOnly":{"type":"boolean","description":"When true, the keys can only make GET and HEAD requests. Writes, deletes, and multipart uploads return AccessDenied.\n","uniqueKey":"authMethods.items.[INDEX].oneOf.2.readOnly","typeLabel":"boolean"}},"uniqueKey":"authMethods.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"authMethods.items.[INDEX]","typeLabel":"object"},"uniqueKey":"authMethods","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"my-data-disk","mounts":[{"type":"s3","bucketName":"my-bucket","accessKeyId":"\u003cstring>","secretAccessKey":"\u003cstring>","sessionToken":"\u003cstring>","bucketPrefix":"data/"}],"authMethods":[{"type":"token","nickname":"\u003cstring>","principal":"\u003cstring>","tokenSuffix":"\u003cstring>","ttl":"\u003cstring>","expiresAt":"2023-11-07T05:31:56Z","oneUse":true,"readOnly":true}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"56f29f31-be84-4c08-861b-f21460651883":{"description":"Disk with this name already exists and configuration matches (idempotent)","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","properties":{"diskId":{"type":"string","example":"dsk-0123456789abcdef","uniqueKey":"data.diskId","typeLabel":"string"},"authorizedUsers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["token","awssts","s3"],"uniqueKey":"data.authorizedUsers.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"principal":{"type":"string","deprecated":true,"description":"Use identifier instead. Only populated for awssts type (the IAM ARN).\n","uniqueKey":"data.authorizedUsers.items.[INDEX].principal","typeLabel":"string"},"nickname":{"type":"string","uniqueKey":"data.authorizedUsers.items.[INDEX].nickname","typeLabel":"string"},"tokenSuffix":{"type":"string","uniqueKey":"data.authorizedUsers.items.[INDEX].tokenSuffix","typeLabel":"string"},"token":{"type":"string","description":"The generated disk token (used by clients when mounting the disk). Only present in the response when the server generates the token (i.e. principal was not provided). This value is shown exactly once and cannot be retrieved again.\n","uniqueKey":"data.authorizedUsers.items.[INDEX].token","typeLabel":"string"},"s3AccessKeyId":{"type":"string","description":"The S3 access key ID. Only present for s3 users.","uniqueKey":"data.authorizedUsers.items.[INDEX].s3AccessKeyId","typeLabel":"string"},"s3SecretKey":{"type":"string","description":"The generated S3 secret access key. Only present in the creation response for s3 users. This value is shown exactly once and cannot be retrieved again.\n","uniqueKey":"data.authorizedUsers.items.[INDEX].s3SecretKey","typeLabel":"string"},"identifier":{"type":"string","description":"Stable identifier for this user, returned in creation and list responses. Use this value with DELETE /api/disks/{id}/users/{type}?identifier={identifier} to remove the user. For awssts users, this is the IAM ARN; for s3 users, the access key ID.\n","uniqueKey":"data.authorizedUsers.items.[INDEX].identifier","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"data.authorizedUsers.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"expiresAt":{"type":"string","format":"date-time","description":"When the user expires. Absent for users without an expiry.","uniqueKey":"data.authorizedUsers.items.[INDEX].expiresAt","typeLabel":"string\u003cdate-time>"},"oneUse":{"type":"boolean","description":"Whether the user can be used for only one mount.","uniqueKey":"data.authorizedUsers.items.[INDEX].oneUse","typeLabel":"boolean"},"consumedAt":{"type":"string","format":"date-time","description":"When a one-use user was consumed by its mount. Absent until then.\n","uniqueKey":"data.authorizedUsers.items.[INDEX].consumedAt","typeLabel":"string\u003cdate-time>"},"readOnly":{"type":"boolean","description":"Whether the user grants read-only access.","uniqueKey":"data.authorizedUsers.items.[INDEX].readOnly","typeLabel":"boolean"},"status":{"type":"string","enum":["active","expired","consumed","in_use"],"description":"Current lifecycle status. `in_use` means a one-use user is being consumed by a mount that is still in progress.\n","uniqueKey":"data.authorizedUsers.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data.authorizedUsers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.authorizedUsers","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"diskId":"dsk-0123456789abcdef","authorizedUsers":[{"type":"token","principal":"\u003cstring>","nickname":"\u003cstring>","tokenSuffix":"\u003cstring>","token":"\u003cstring>","s3AccessKeyId":"\u003cstring>","s3SecretKey":"\u003cstring>","identifier":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","expiresAt":"2023-11-07T05:31:56Z","oneUse":true,"consumedAt":"2023-11-07T05:31:56Z","readOnly":true,"status":"active"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"c2b59f9a-4dda-437a-ada0-59b755c7ab90":{"description":"Disk created successfully","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","properties":{"diskId":{"type":"string","example":"dsk-0123456789abcdef","uniqueKey":"data.diskId","typeLabel":"string"},"authorizedUsers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["token","awssts","s3"],"uniqueKey":"data.authorizedUsers.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"principal":{"type":"string","deprecated":true,"description":"Use identifier instead. Only populated for awssts type (the IAM ARN).\n","uniqueKey":"data.authorizedUsers.items.[INDEX].principal","typeLabel":"string"},"nickname":{"type":"string","uniqueKey":"data.authorizedUsers.items.[INDEX].nickname","typeLabel":"string"},"tokenSuffix":{"type":"string","uniqueKey":"data.authorizedUsers.items.[INDEX].tokenSuffix","typeLabel":"string"},"token":{"type":"string","description":"The generated disk token (used by clients when mounting the disk). Only present in the response when the server generates the token (i.e. principal was not provided). This value is shown exactly once and cannot be retrieved again.\n","uniqueKey":"data.authorizedUsers.items.[INDEX].token","typeLabel":"string"},"s3AccessKeyId":{"type":"string","description":"The S3 access key ID. Only present for s3 users.","uniqueKey":"data.authorizedUsers.items.[INDEX].s3AccessKeyId","typeLabel":"string"},"s3SecretKey":{"type":"string","description":"The generated S3 secret access key. Only present in the creation response for s3 users. This value is shown exactly once and cannot be retrieved again.\n","uniqueKey":"data.authorizedUsers.items.[INDEX].s3SecretKey","typeLabel":"string"},"identifier":{"type":"string","description":"Stable identifier for this user, returned in creation and list responses. Use this value with DELETE /api/disks/{id}/users/{type}?identifier={identifier} to remove the user. For awssts users, this is the IAM ARN; for s3 users, the access key ID.\n","uniqueKey":"data.authorizedUsers.items.[INDEX].identifier","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"data.authorizedUsers.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"expiresAt":{"type":"string","format":"date-time","description":"When the user expires. Absent for users without an expiry.","uniqueKey":"data.authorizedUsers.items.[INDEX].expiresAt","typeLabel":"string\u003cdate-time>"},"oneUse":{"type":"boolean","description":"Whether the user can be used for only one mount.","uniqueKey":"data.authorizedUsers.items.[INDEX].oneUse","typeLabel":"boolean"},"consumedAt":{"type":"string","format":"date-time","description":"When a one-use user was consumed by its mount. Absent until then.\n","uniqueKey":"data.authorizedUsers.items.[INDEX].consumedAt","typeLabel":"string\u003cdate-time>"},"readOnly":{"type":"boolean","description":"Whether the user grants read-only access.","uniqueKey":"data.authorizedUsers.items.[INDEX].readOnly","typeLabel":"boolean"},"status":{"type":"string","enum":["active","expired","consumed","in_use"],"description":"Current lifecycle status. `in_use` means a one-use user is being consumed by a mount that is still in progress.\n","uniqueKey":"data.authorizedUsers.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data.authorizedUsers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.authorizedUsers","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"diskId":"dsk-0123456789abcdef","authorizedUsers":[{"type":"token","principal":"\u003cstring>","nickname":"\u003cstring>","tokenSuffix":"\u003cstring>","token":"\u003cstring>","s3AccessKeyId":"\u003cstring>","s3SecretKey":"\u003cstring>","identifier":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","expiresAt":"2023-11-07T05:31:56Z","oneUse":true,"consumedAt":"2023-11-07T05:31:56Z","readOnly":true,"status":"active"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"461c3c43-a4e6-4ad4-b2f2-b99bd0fad066":{"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"},"0ebae9ac-7977-4819-a9ca-c5435bf0c7b8":{"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"},"d79a7820-8bc0-4e55-a390-cad23e30d5f6":{"description":"Access denied (e.g., preview region not enabled)","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"},"078fd987-3349-47e4-8ea6-54363a276ae4":{"description":"Disk with this name already exists but configuration differs","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"},"b87b85ad-a70b-452d-ab5c-5f593dc240e0":{"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"}},"security":{"d4e1daaa-47eb-499e-9fff-d91128fbd239":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"Archil API key, including its `key-` prefix","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"b1342687-6cb8-4a7e-8bf7-37e1e6785396":{"url":"https://control.green.us-east-1.aws.prod.archil.com","description":"AWS US East (N. Virginia) — aws-us-east-1"},"ccc4eea5-2d5f-4c21-90b3-49f4e1a5c133":{"url":"https://control.green.eu-west-1.aws.prod.archil.com","description":"AWS EU West (Ireland) — aws-eu-west-1"},"641e25ad-2e75-4766-9aee-dcccff02838a":{"url":"https://control.green.us-west-2.aws.prod.archil.com","description":"AWS US West (Oregon) — aws-us-west-2"},"6f0c44fb-45f8-42a1-b3f2-9c5e38dc6f60":{"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":"Create Disk - Archil","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-11T00:32:30.735Z","originalFileLocation":"api-reference/disks/create-disk.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=\"Creates a new disk with the specified configuration. A default disk token user is automatically generated and returned in the response, so the disk is immediately mountable. The one-time disk token appears in authorizedUsers[].token and cannot be retrieved again. (This disk token is scoped to the new disk and is separate from the API key you used to make this request.) To provide your own users instead, pass the deprecated authMethods field or call AddDiskUser after creation.\">\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=\"Create Disk - Archil\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new disk with the specified configuration. A default disk token user is automatically generated and returned in the response, so the disk is immediately mountable. The one-time disk token appears in authorizedUsers[].token and cannot be retrieved again. (This disk token is scoped to the new disk and is separate from the API key you used to make this request.) To provide your own users instead, pass the deprecated authMethods field or call AddDiskUser after creation.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Archil\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.archil.com/api-reference/disks/create-disk\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://regattastorage.mintlify.site/_mintlify/api/og/v2?division=Disks\u0026amp;title=Create+Disk\u0026amp;description=Creates+a+new+disk+with+the+specified+configuration.+A+default+disk%0Atoken+user+is+automatically+generated+and+returned+in+the+response%2C%0Aso+the+disk+is+immediate\u0026amp;theme=f9cc175363129fdea211f9f4\u0026amp;signature=45869fa2141bb976850c46fb96922c716444633b18523ed16ae7927945fc4a78\">\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=\"Create Disk - Archil\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new disk with the specified configuration. A default disk token user is automatically generated and returned in the response, so the disk is immediately mountable. The one-time disk token appears in authorizedUsers[].token and cannot be retrieved again. (This disk token is scoped to the new disk and is separate from the API key you used to make this request.) To provide your own users instead, pass the deprecated authMethods field or call AddDiskUser after creation.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://regattastorage.mintlify.site/_mintlify/api/og/v2?division=Disks\u0026amp;title=Create+Disk\u0026amp;description=Creates+a+new+disk+with+the+specified+configuration.+A+default+disk%0Atoken+user+is+automatically+generated+and+returned+in+the+response%2C%0Aso+the+disk+is+immediate\u0026amp;theme=f9cc175363129fdea211f9f4\u0026amp;signature=45869fa2141bb976850c46fb96922c716444633b18523ed16ae7927945fc4a78\">\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/disks/create-disk\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/disks/create-disk.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/disks/create-disk#webpage\",\"url\":\"https://docs.archil.com/api-reference/disks/create-disk\",\"name\":\"Create Disk\",\"description\":\"Creates a new disk with the specified configuration. A default disk token user is automatically generated and returned in the response, so the disk is immediately mountable. The one-time disk token appears in authorizedUsers[].token and cannot be retrieved again. (This disk token is scoped to the new disk and is separate from the API key you used to make this request.) To provide your own users instead, pass the deprecated authMethods field or call AddDiskUser after creation.\",\"dateModified\":\"2026-04-11T00:32:30.735Z\",\"isPartOf\":{\"@id\":\"https://docs.archil.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.archil.com/api-reference/disks/create-disk#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.archil.com/api-reference/disks/create-disk#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Disks\",\"item\":\"https://docs.archil.com/api-reference/disks/list-disks\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Disk\",\"item\":\"https://docs.archil.com/api-reference/disks/create-disk\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.archil.com/api-reference/disks/create-disk#apireference\",\"headline\":\"Create Disk\",\"name\":\"Create Disk\",\"description\":\"Creates a new disk with the specified configuration. A default disk token user is automatically generated and returned in the response, so the disk is immediately mountable. The one-time disk token appears in authorizedUsers[].token and cannot be retrieved again. (This disk token is scoped to the new disk and is separate from the API key you used to make this request.) To provide your own users instead, pass the deprecated authMethods field or call AddDiskUser after creation.\",\"url\":\"https://docs.archil.com/api-reference/disks/create-disk\",\"mainEntityOfPage\":{\"@id\":\"https://docs.archil.com/api-reference/disks/create-disk#webpage\"},\"dateModified\":\"2026-04-11T00:32:30.735Z\",\"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\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Archil\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/disks/create-disk.md","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","description":"Returns all disks owned by the authenticated account.","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}","description":"Returns detailed information about a specific disk.","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"},{"title":"Prefetch File Ranges","openapi":"POST /api/disks/{id}/prefetch","href":"/api-reference/disks/prefetch-disk"}]},{"group":"Serverless Execution","pages":[{"title":"Execute Command on Disk","openapi":"POST /api/disks/{id}/exec","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","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":"Get Sandbox Usage","openapi":"GET /api/sandboxes/{sid}/usage","href":"/api-reference/sandboxes/get-sandbox-usage"},{"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 Subscription","openapi":"GET /api/billing/subscription","href":"/api-reference/billing/get-subscription"},{"title":"Get Usage","openapi":"GET /api/billing/usage","href":"/api-reference/billing/get-usage"},{"title":"Get Summary","openapi":"GET /api/billing/summary","href":"/api-reference/billing/get-summary"}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/agents/coding-agent"}]}]},"basePath":"","title":"Create Disk - Archil","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}