{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Archal","description":"Create testing sandboxes with isolated, stateful provider environments.","colors":{"primary":"#A8887A","light":"#C1A89C","dark":"#7A6C5A"},"logo":{"light":"https://mintcdn.com/archallabs/IGeHrsqAwIcGu23r/logo/archal-mark.png?fit=max\u0026auto=format\u0026n=IGeHrsqAwIcGu23r\u0026q=85\u0026s=8078899310b6e3d2efa751734115c6e7","dark":"https://mintcdn.com/archallabs/IGeHrsqAwIcGu23r/logo/archal-mark.png?fit=max\u0026auto=format\u0026n=IGeHrsqAwIcGu23r\u0026q=85\u0026s=8078899310b6e3d2efa751734115c6e7","href":"https://archal.ai"},"favicon":"https://mintcdn.com/archallabs/IGeHrsqAwIcGu23r/favicon.png?fit=max\u0026auto=format\u0026n=IGeHrsqAwIcGu23r\u0026q=85\u0026s=1e9f095639a2789438f18526d6c1c8a4","appearance":{"default":"dark"},"background":{"color":{"light":"#F7F3EC","dark":"#0A0806"}},"navbar":{"links":[{"href":"https://archal.ai/dashboard","label":"Dashboard"}]},"footer":{"socials":{"github":"https://github.com/Archal-Labs/archal","website":"https://archal.ai"},"links":[{"header":"Archal","items":[{"label":"Home","href":"https://archal.ai"},{"label":"Dashboard","href":"https://archal.ai/dashboard"}]},{"header":"Docs","items":[{"label":"Start","href":"https://docs.archal.ai/introduction"},{"label":"Sandboxes","href":"https://docs.archal.ai/sandboxes/overview"},{"label":"Environments","href":"https://docs.archal.ai/environments/overview"},{"label":"API reference","href":"https://docs.archal.ai/api-reference/openapi.json"}]},{"header":"Company","items":[{"label":"Contact","href":"https://archal.ai/contact"},{"label":"GitHub","href":"https://github.com/Archal-Labs/archal"}]}]},"seo":{"metatags":{"og:site_name":"Archal Docs","og:image":"https://docs.archal.ai/images/og-default.png","twitter:card":"summary_large_image","twitter:image":"https://docs.archal.ai/images/og-default.png"},"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":600,"source":"google","format":"woff2"},"body":{"family":"Inter","source":"google","format":"woff2"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"archallabs","hasAudioNarration":false,"actualSubdomain":"archallabs","customDomains":["docs.archal.ai"],"gitSource":{"type":"github","owner":"archal-labs","repo":"archal","deployBranch":"main","contentDirectory":"apps/web/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a928e5b08b3839763e4be45","collectionId":"764508c1-61dd-4410-94b4-7f0893b71e48","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a928e5b08b3839763e4be45"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6a928e5b08b3839763e4be45","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":51},{"language":"default","tag":"Environments","count":46},{"language":"default","tag":"OpenAPI","count":21},{"language":"default","tag":"Sandboxes","count":12},{"language":"default","tag":"Start","count":10},{"language":"default","tag":"Integrate","count":10},{"language":"default","tag":"Guides","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":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":"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":"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":"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":"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":"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":"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":"sso-setup-deadline-banner","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/create-environments-with-optional-initial-state","slug":"/api-reference/create-environments-with-optional-initial-state","pageMetadata":{"title":"Create environments with optional initial state","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sessions","href":"/api-reference/create-environments-with-optional-initial-state","autogeneratedByOpenApi":true},"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 environments with optional initial state","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sessions","href":"/api-reference/create-environments-with-optional-initial-state","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createEnvironmentSession","summary":"Create environments with optional initial state","security":["51d58b7c-0e05-47b2-b130-97a12790202d"],"parameters":["c8a40383-32ce-48cc-9c52-6ae5dd42a95f"],"requestBody":"9d7a6c36-b991-4304-8148-fe06dc95c4cf","responses":{"201":"4be82179-4445-4b0d-ba0c-6ee35732f067","400":"febd6174-8d82-441b-b3e0-c75c9123feee","401":"833e05e1-cbf1-453e-a1ff-9e661f9762f6","402":"e873cc49-821e-4c3f-bbbc-6901de9106af","403":"341919c1-a759-45cf-a442-fb4942988de1","404":"0f240e3e-cdd0-440e-abd0-901833a89a01","409":"9111e7e5-e5f9-44ad-8a64-69a12fdb4748","413":"31d7b25f-504a-4702-a460-997c2bb5156f","429":"820b08b5-4373-4754-b768-e15686914284","500":"13b1cce5-b5ed-462a-b696-ba00f1499214","502":"f4d753ea-1f71-4421-a477-ae8bda505aa5","503":"f2454da0-2f42-444b-8f68-ba28a50817a5"},"method":"post","type":"path","servers":["a4229ab5-3bbc-43ad-a83d-4cd2da5a5451"],"path":"/api/sessions","baseUrlOptions":["https://api.archal.ai"],"title":"Create environments with optional initial state","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c8a40383-32ce-48cc-9c52-6ae5dd42a95f":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environments":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":80,"uniqueKey":"environments.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"environments","typeLabel":"string[]"},"ttlSeconds":{"type":"integer","minimum":1,"maximum":14400,"uniqueKey":"ttlSeconds","typeLabel":"integer"},"initialState":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":80},"additionalProperties":{"oneOf":[{"type":"object","required":["format","value"],"properties":{"format":{"type":"string","const":"json","isRequired":true,"uniqueKey":"initialState.additionalProperties.oneOf.0.format","typeLabel":"string"},"value":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"initialState.additionalProperties.oneOf.0.value.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"initialState.additionalProperties.oneOf.0.value","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"initialState.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["format","value"],"properties":{"format":{"type":"string","const":"sql","isRequired":true,"uniqueKey":"initialState.additionalProperties.oneOf.1.format","typeLabel":"string"},"value":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"initialState.additionalProperties.oneOf.1.value","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"initialState.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"initialState.additionalProperties","typeLabel":"object"},"uniqueKey":"initialState","typeLabel":"object"}},"required":["environments"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"environments":["\u003cstring>"],"ttlSeconds":7200,"initialState":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"4be82179-4445-4b0d-ba0c-6ee35732f067":{"description":"Environment session created","content":{"application/json":{"schema":{"type":"object","properties":{"sessionId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"sessionId","typeLabel":"string"},"status":{"type":"string","enum":["starting","ready","running","tearing_down","ended","expired","failed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"environmentIds":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":80,"uniqueKey":"environmentIds.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"environmentIds","typeLabel":"string[]"},"environments":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":80},"additionalProperties":{"oneOf":[{"type":"object","required":["status","apiBaseUrl","mcpUrl","credentials"],"properties":{"status":{"type":"string","const":"ready","isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.0.status","typeLabel":"string"},"apiBaseUrl":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.0.apiBaseUrl","typeLabel":"string\u003curi>"},"mcpUrl":{"oneOf":[{"type":"string","format":"uri","isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.0.mcpUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.0.mcpUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.0.mcpUrl","typeLabel":"string\u003curi> | null"},"credentials":{"type":"object","properties":{"kind":{"type":"string","const":"provider","isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.0.credentials.kind","typeLabel":"string"},"expiresAt":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.0.credentials.expiresAt","typeLabel":"string"},"headers":{"type":"object","propertyNames":{"type":"string","minLength":1},"additionalProperties":{"type":"string","minLength":1,"uniqueKey":"environments.additionalProperties.oneOf.0.credentials.headers.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.0.credentials.headers","typeLabel":"object"}},"required":["kind","expiresAt","headers"],"additionalProperties":false,"isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.0.credentials","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"environments.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["status","apiBaseUrl","mcpUrl","credentials"],"properties":{"status":{"type":"string","enum":["starting","dead"],"isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.1.status","typeLabel":"enum\u003cstring>"},"apiBaseUrl":{"type":"null","isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.1.apiBaseUrl","typeLabel":"null"},"mcpUrl":{"type":"null","isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.1.mcpUrl","typeLabel":"null"},"credentials":{"type":"null","isRequired":true,"uniqueKey":"environments.additionalProperties.oneOf.1.credentials","typeLabel":"null"}},"additionalProperties":false,"uniqueKey":"environments.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"environments.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"environments","typeLabel":"object"},"expiresAt":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"expiresAt","typeLabel":"string"},"certificationWarnings":{"type":"array","items":{"type":"object","properties":{"environmentId":{"type":"string","minLength":1,"maxLength":80,"isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].environmentId","typeLabel":"string"},"code":{"type":"string","const":"ENVIRONMENT_CERTIFICATION_DEGRADED","isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].message","typeLabel":"string"},"certification":{"type":"object","properties":{"status":{"type":"string","enum":["healthy","degraded","quarantined","unknown"],"isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].certification.status","typeLabel":"enum\u003cstring>"},"admission":{"type":"string","enum":["allow","warn","deny"],"isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].certification.admission","typeLabel":"enum\u003cstring>"},"checkedAt":{"oneOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].certification.checkedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].certification.checkedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].certification.checkedAt","typeLabel":"string\u003cdate-time> | null"},"evidenceSha256":{"oneOf":[{"type":"string","pattern":"^[a-f0-9]{64}$","isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].certification.evidenceSha256.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].certification.evidenceSha256.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].certification.evidenceSha256","typeLabel":"string | null"}},"required":["status","admission","checkedAt","evidenceSha256"],"additionalProperties":false,"isRequired":true,"uniqueKey":"certificationWarnings.items.[INDEX].certification","typeLabel":"object"}},"required":["environmentId","code","message","certification"],"additionalProperties":false,"uniqueKey":"certificationWarnings.items.[INDEX]","typeLabel":"object"},"uniqueKey":"certificationWarnings","typeLabel":"object[]"},"lease":{"type":"object","properties":{"expiresAt":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"lease.expiresAt","typeLabel":"string"},"idleExpiresAt":{"oneOf":[{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"lease.idleExpiresAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"lease.idleExpiresAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lease.idleExpiresAt","typeLabel":"string | null"},"hardExpiresAt":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"lease.hardExpiresAt","typeLabel":"string"},"renewable":{"type":"boolean","isRequired":true,"uniqueKey":"lease.renewable","typeLabel":"boolean"}},"required":["expiresAt","idleExpiresAt","hardExpiresAt","renewable"],"additionalProperties":false,"uniqueKey":"lease","typeLabel":"object"},"workspace":{"type":"object","properties":{"id":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"workspace.id","typeLabel":"string"},"name":{"type":"string","minLength":1,"uniqueKey":"workspace.name","typeLabel":"string"}},"required":["id"],"additionalProperties":false,"uniqueKey":"workspace","typeLabel":"object"}},"required":["sessionId","status","environmentIds","environments","expiresAt"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"sessionId":"\u003cstring>","status":"starting","environmentIds":["\u003cstring>"],"environments":{},"expiresAt":"\u003cstring>","certificationWarnings":[{"environmentId":"\u003cstring>","code":"ENVIRONMENT_CERTIFICATION_DEGRADED","message":"\u003cstring>","certification":{"status":"healthy","admission":"allow","checkedAt":"2023-11-07T05:31:56Z","evidenceSha256":"\u003cstring>"}}],"lease":{"expiresAt":"\u003cstring>","idleExpiresAt":"\u003cstring>","hardExpiresAt":"\u003cstring>","renewable":true},"workspace":{"id":"\u003cstring>","name":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"febd6174-8d82-441b-b3e0-c75c9123feee":{"description":"The request was rejected","headers":{"X-Request-Id":{"description":"Request correlation identifier","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying when present","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":true,"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"error":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","issues":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"833e05e1-cbf1-453e-a1ff-9e661f9762f6":{"description":"The request was rejected","headers":{"X-Request-Id":{"description":"Request correlation identifier","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying when present","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":true,"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"error":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","issues":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"e873cc49-821e-4c3f-bbbc-6901de9106af":{"description":"The request was rejected","headers":{"X-Request-Id":{"description":"Request correlation identifier","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying when present","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":true,"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"error":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","issues":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"341919c1-a759-45cf-a442-fb4942988de1":{"description":"The request was rejected","headers":{"X-Request-Id":{"description":"Request correlation identifier","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying when present","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":true,"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"error":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","issues":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"0f240e3e-cdd0-440e-abd0-901833a89a01":{"description":"The request was rejected","headers":{"X-Request-Id":{"description":"Request correlation identifier","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying when present","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":true,"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"error":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","issues":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"9111e7e5-e5f9-44ad-8a64-69a12fdb4748":{"description":"The request was rejected","headers":{"X-Request-Id":{"description":"Request correlation identifier","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying when present","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":true,"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"error":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","issues":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"31d7b25f-504a-4702-a460-997c2bb5156f":{"description":"The request was rejected","headers":{"X-Request-Id":{"description":"Request correlation identifier","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying when present","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":true,"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"error":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","issues":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"820b08b5-4373-4754-b768-e15686914284":{"description":"The request was rejected","headers":{"X-Request-Id":{"description":"Request correlation identifier","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying when present","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":true,"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"error":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","issues":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"13b1cce5-b5ed-462a-b696-ba00f1499214":{"description":"The request was rejected","headers":{"X-Request-Id":{"description":"Request correlation identifier","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying when present","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":true,"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"error":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","issues":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"f4d753ea-1f71-4421-a477-ae8bda505aa5":{"description":"The request was rejected","headers":{"X-Request-Id":{"description":"Request correlation identifier","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying when present","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":true,"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"error":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","issues":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"f2454da0-2f42-444b-8f68-ba28a50817a5":{"description":"The request was rejected","headers":{"X-Request-Id":{"description":"Request correlation identifier","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying when present","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":true,"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"error":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","issues":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"51d58b7c-0e05-47b2-b130-97a12790202d":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Archal workspace API key","description":"Used by lifecycle, catalog, and state endpoints","scopes":[]}}},"servers":{"a4229ab5-3bbc-43ad-a83d-4cd2da5a5451":{"url":"https://api.archal.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"Archal workspace API key","description":"Used by lifecycle, catalog, and state endpoints","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Used by lifecycle, catalog, and state endpoints","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"archallabs","siteName":"Archal","title":"Create environments with optional initial state - Archal","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-29T07:46:51.124Z","originalFileLocation":"api-reference/create-environments-with-optional-initial-state.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=\"dark\"}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=\"application-name\" content=\"Archal\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/archallabs/sxRzDHx4Ey09YHTe/_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/archallabs/sxRzDHx4Ey09YHTe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/archallabs/sxRzDHx4Ey09YHTe/_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/archallabs/sxRzDHx4Ey09YHTe/_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/archallabs/sxRzDHx4Ey09YHTe/_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/archallabs/sxRzDHx4Ey09YHTe/_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/archallabs/sxRzDHx4Ey09YHTe/_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/archallabs/sxRzDHx4Ey09YHTe/_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/archallabs/sxRzDHx4Ey09YHTe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create environments with optional initial state - Archal\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Archal Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.archal.ai/api-reference/create-environments-with-optional-initial-state\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.archal.ai/images/og-default.png\">\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 environments with optional initial state - Archal\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.archal.ai/images/og-default.png\">\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/archallabs/sxRzDHx4Ey09YHTe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Archal\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#A8887A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.archal.ai/api-reference/create-environments-with-optional-initial-state\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/create-environments-with-optional-initial-state.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.archal.ai/#organization\",\"name\":\"Archal\",\"url\":\"https://docs.archal.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/archallabs/IGeHrsqAwIcGu23r/logo/archal-mark.png?fit=max\u0026auto=format\u0026n=IGeHrsqAwIcGu23r\u0026q=85\u0026s=8078899310b6e3d2efa751734115c6e7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.archal.ai#website\",\"name\":\"Archal\",\"url\":\"https://docs.archal.ai\",\"publisher\":{\"@id\":\"https://docs.archal.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.archal.ai/api-reference/create-environments-with-optional-initial-state#webpage\",\"url\":\"https://docs.archal.ai/api-reference/create-environments-with-optional-initial-state\",\"name\":\"Create environments with optional initial state\",\"dateModified\":\"2026-08-29T07:46:51.124Z\",\"isPartOf\":{\"@id\":\"https://docs.archal.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.archal.ai/api-reference/create-environments-with-optional-initial-state#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.archal.ai/api-reference/create-environments-with-optional-initial-state#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"OpenAPI\",\"item\":\"https://docs.archal.ai/api-reference/list-environment-capabilities-and-state-contracts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://docs.archal.ai/api-reference/list-environment-capabilities-and-state-contracts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create environments with optional initial state\",\"item\":\"https://docs.archal.ai/api-reference/create-environments-with-optional-initial-state\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.archal.ai/api-reference/create-environments-with-optional-initial-state#apireference\",\"headline\":\"Create environments with optional initial state\",\"name\":\"Create environments with optional initial state\",\"url\":\"https://docs.archal.ai/api-reference/create-environments-with-optional-initial-state\",\"mainEntityOfPage\":{\"@id\":\"https://docs.archal.ai/api-reference/create-environments-with-optional-initial-state#webpage\"},\"image\":\"https://docs.archal.ai/images/og-default.png\",\"dateModified\":\"2026-08-29T07:46:51.124Z\",\"publisher\":{\"@id\":\"https://docs.archal.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.archal.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Archal\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Archal","nav":{"global":null,"tabs":[{"tab":"Start","pages":[{"title":"Start","href":"/introduction"}]},{"tab":"Sandboxes","pages":[{"title":"Sandboxes","href":"/sandboxes/overview"}]},{"tab":"Environments","pages":[{"title":"Environments","href":"/environments/overview"}]},{"tab":"Integrate","pages":[{"title":"Integrate","href":"/integrations/coding-agents"}]},{"tab":"API Reference","groups":[{"group":"Guides","pages":[{"title":"Authentication","href":"/api/authentication"},{"title":"Sandbox lifecycle API","href":"/api/lifecycle"},{"title":"State API","href":"/api/starting-state"},{"title":"Call an environment","href":"/api/call-environment"},{"title":"Reset API","href":"/api/reset-state"},{"title":"Errors and retries","href":"/api/errors-retries"},{"title":"Idempotency","href":"/api/idempotency"},{"title":"Limits and usage","href":"/api/limits-usage"},{"title":"Data handling and security","href":"/security"}]},{"group":"OpenAPI","pages":[{"group":"API Reference","pages":[{"title":"List environment capabilities and state contracts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/environments","href":"/api-reference/list-environment-capabilities-and-state-contracts"},{"title":"Describe one environment and its certification","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/environments/{environmentId}","href":"/api-reference/describe-one-environment-and-its-certification"},{"title":"Validate state without starting an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/environments/{environmentId}/state/validate","href":"/api-reference/validate-state-without-starting-an-environment"},{"title":"List environment sessions","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sessions","href":"/api-reference/list-environment-sessions"},{"title":"Create environments with optional initial state","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sessions","href":"/api-reference/create-environments-with-optional-initial-state"},{"title":"Inspect readiness and environment connection URLs","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sessions/{sessionId}","href":"/api-reference/inspect-readiness-and-environment-connection-urls"},{"title":"Destroy a session and release its runtime resources","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/sessions/{sessionId}","href":"/api-reference/destroy-a-session-and-release-its-runtime-resources"},{"title":"Extend an active environment session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sessions/{sessionId}/renew","href":"/api-reference/extend-an-active-environment-session"},{"title":"Reset every stateful environment in a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sessions/{sessionId}/reset","href":"/api-reference/reset-every-stateful-environment-in-a-session"},{"title":"Inspect environment state","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sessions/{sessionId}/environments/{environmentId}/state","href":"/api-reference/inspect-environment-state"},{"title":"Replace environment state and its reset baseline","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/sessions/{sessionId}/environments/{environmentId}/state","href":"/api-reference/replace-environment-state-and-its-reset-baseline"},{"title":"Reset one environment to its baseline","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sessions/{sessionId}/environments/{environmentId}/reset","href":"/api-reference/reset-one-environment-to-its-baseline"},{"title":"Compare explicit prior state with current state","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sessions/{sessionId}/environments/{environmentId}/state/diff","href":"/api-reference/compare-explicit-prior-state-with-current-state"},{"title":"Get bounded request metadata and retention status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sessions/{sessionId}/evidence","href":"/api-reference/get-bounded-request-metadata-and-retention-status"},{"title":"Send a GET request to an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sessions/{sessionId}/environments/{environmentId}/api/{providerPath}","href":"/api-reference/send-a-get-request-to-an-environment"},{"title":"Send a PUT request to an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/sessions/{sessionId}/environments/{environmentId}/api/{providerPath}","href":"/api-reference/send-a-put-request-to-an-environment"},{"title":"Send a POST request to an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/sessions/{sessionId}/environments/{environmentId}/api/{providerPath}","href":"/api-reference/send-a-post-request-to-an-environment"},{"title":"Send a DELETE request to an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/sessions/{sessionId}/environments/{environmentId}/api/{providerPath}","href":"/api-reference/send-a-delete-request-to-an-environment"},{"title":"Send a HEAD request to an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json head /v1/sessions/{sessionId}/environments/{environmentId}/api/{providerPath}","href":"/api-reference/send-a-head-request-to-an-environment"},{"title":"Send a PATCH request to an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/sessions/{sessionId}/environments/{environmentId}/api/{providerPath}","href":"/api-reference/send-a-patch-request-to-an-environment"},{"title":"Send a Streamable HTTP MCP request to an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/sessions/{sessionId}/environments/{environmentId}/mcp","href":"/api-reference/send-a-streamable-http-mcp-request-to-an-environment"}]}]}]}]},"basePath":"","title":"Create environments with optional initial state - Archal","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}