The cloud's credentials. For aws: access_key, secret_key and optionally region. For gcp: the fields of the service account key file, and optionally region (a zone or a region). For azure: subscription_id, tenant_id, client_id, client_secret and optionally region.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Airship","description":"Airship launches a fresh machine in your own AWS, Google Cloud or Azure account for every GitHub Actions job, from one airship.yaml per repository.","colors":{"primary":"#3064ff","light":"#9efaff","dark":"#1f4ed8"},"logo":{"light":"https://mintcdn.com/airship/glanO3aKL9ONqfLd/logo/light.svg?fit=max\u0026auto=format\u0026n=glanO3aKL9ONqfLd\u0026q=85\u0026s=2fd1e7804f107307629dc88ce4da33f2","dark":"https://mintcdn.com/airship/glanO3aKL9ONqfLd/logo/dark.svg?fit=max\u0026auto=format\u0026n=glanO3aKL9ONqfLd\u0026q=85\u0026s=e8941711aaf8500127efe9f3252ef13f","href":"https://airshipci.com"},"favicon":"https://mintcdn.com/airship/glanO3aKL9ONqfLd/favicon.svg?fit=max\u0026auto=format\u0026n=glanO3aKL9ONqfLd\u0026q=85\u0026s=82352dc1ccd241cb27abcefc4960b247","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript","go"]}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"https://airshipci.com","label":"airshipci.com"}],"primary":{"type":"button","label":"Open dashboard","href":"https://app.airshipci.com"}},"footer":{"socials":{"website":"https://airshipci.com"},"links":[{"header":"Get started","items":[{"label":"Quickstart","href":"/quickstart"},{"label":"How it works","href":"/how-it-works"},{"label":"Connect a cloud","href":"/clouds/overview"}]},{"header":"Reference","items":[{"label":"airship.yaml","href":"/configuration/overview"},{"label":"Developer API","href":"/api-reference/introduction"},{"label":"Troubleshooting","href":"/troubleshooting"}]},{"header":"Airship","items":[{"label":"Pricing","href":"https://airshipci.com/pricing"},{"label":"Dashboard","href":"https://app.airshipci.com"},{"label":"Security","href":"/security"}]}]},"search":{"prompt":"Search the Airship docs"},"seo":{"metatags":{"og:site_name":"Airship documentation"}},"fonts":{"family":"Geist"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","claude","chatgpt","mcp"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"airship","hasAudioNarration":false,"actualSubdomain":"airship","customDomains":[],"gitSource":{"type":"github","owner":"airship-ci","repo":"airship","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":"","_id":"6ae1d57bd15925e7569909af"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae1d5b9d15925e756990d6e","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Getting Started","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/developer-api/connect-a-cloud","slug":"/api-reference/developer-api/connect-a-cloud","pageMetadata":{"title":"Connect a cloud","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/cloud-connect","href":"/api-reference/developer-api/connect-a-cloud","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":"Connect a cloud","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/cloud-connect","href":"/api-reference/developer-api/connect-a-cloud","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"compatCloudConnect","requestBody":"62bfadad-78a2-4cac-a5f3-b99c35d972af","responses":{"200":"7afaefd7-f1c3-4108-922b-e9b2275edc07","default":"48017b8e-feaa-4fe7-b4aa-c271e7280f2b"},"security":["2854c136-34be-47c6-b876-17b76d8f67e4"],"summary":"Connect a cloud","tags":["Developer API"],"method":"post","type":"path","servers":["90eda533-3eea-4cba-b6d1-af6d4c026737","01776530-a650-4ce7-9e3f-3c6271a8fed1"],"path":"/api/v1/cloud-connect","baseUrlOptions":["https://api.airshipci.com","https://{host}"],"title":"Connect a cloud","description":"","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"cloud":{"description":"Cloud name","enum":["aws","gcp","azure"],"type":"string","isRequired":true,"uniqueKey":"cloud","typeLabel":"enum\u003cstring>"},"credentials":{"additionalProperties":{"type":"string","uniqueKey":"credentials.additionalProperties","typeLabel":"string"},"description":"The cloud's credentials. For `aws`: `access_key`, `secret_key` and optionally `region`. For `gcp`: the fields of the service account key file, and optionally `region` (a zone or a region). For `azure`: `subscription_id`, `tenant_id`, `client_id`, `client_secret` and optionally `region`.","maxProperties":20,"type":"object","isRequired":true,"uniqueKey":"credentials","typeLabel":"object"}},"required":["cloud","credentials"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"credentials":{}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"7afaefd7-f1c3-4108-922b-e9b2275edc07":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"accountId":{"oneOf":[{"description":"The cloud's own account identifier: an AWS account ID, a Google Cloud project ID or an Azure subscription ID","type":"string","isRequired":true,"uniqueKey":"accountId.oneOf.0","typeLabel":"string"},{"description":"The cloud's own account identifier: an AWS account ID, a Google Cloud project ID or an Azure subscription ID","type":"null","isRequired":true,"uniqueKey":"accountId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"accountId","typeLabel":"string | null"},"cloud":{"description":"Cloud name","enum":["aws","gcp","azure"],"type":"string","isRequired":true,"uniqueKey":"cloud","typeLabel":"enum\u003cstring>"},"connectedAt":{"description":"When it was connected","format":"date-time","type":"string","isRequired":true,"uniqueKey":"connectedAt","typeLabel":"string\u003cdate-time>"},"defaultRegion":{"description":"The region runners launch in when a runner definition names none; on Google Cloud, a zone or a region","type":"string","isRequired":true,"uniqueKey":"defaultRegion","typeLabel":"string"},"error":{"oneOf":[{"description":"Why the credential stopped working","type":"string","isRequired":true,"uniqueKey":"error.oneOf.0","typeLabel":"string"},{"description":"Why the credential stopped working","type":"null","isRequired":true,"uniqueKey":"error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error","typeLabel":"string | null"},"identity":{"description":"The public half of the credential: an AWS access key ID, a Google Cloud service account email or an Azure application ID","type":"string","isRequired":true,"uniqueKey":"identity","typeLabel":"string"},"principal":{"oneOf":[{"description":"Who the credential is, such as an IAM user's ARN","type":"string","isRequired":true,"uniqueKey":"principal.oneOf.0","typeLabel":"string"},{"description":"Who the credential is, such as an IAM user's ARN","type":"null","isRequired":true,"uniqueKey":"principal.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"principal","typeLabel":"string | null"},"status":{"description":"Whether the credential works","enum":["ok","invalid"],"type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"updatedAt":{"description":"When it was last changed","format":"date-time","type":"string","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"verifiedAt":{"oneOf":[{"description":"When it was last verified with the cloud","format":"date-time","type":"string","isRequired":true,"uniqueKey":"verifiedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"When it was last verified with the cloud","format":"date-time","type":"null","isRequired":true,"uniqueKey":"verifiedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"verifiedAt","typeLabel":"string\u003cdate-time> | null"}},"required":["cloud","identity","accountId","principal","defaultRegion","status","error","verifiedAt","connectedAt","updatedAt"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"accountId":"\u003cstring>","cloud":"aws","connectedAt":"2023-11-07T05:31:56Z","defaultRegion":"\u003cstring>","error":"\u003cstring>","identity":"\u003cstring>","principal":"\u003cstring>","status":"ok","updatedAt":"2023-11-07T05:31:56Z","verifiedAt":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"description":"OK","exampleType":"generated"},"48017b8e-feaa-4fe7-b4aa-c271e7280f2b":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Error","exampleType":"generated"}},"security":{"2854c136-34be-47c6-b876-17b76d8f67e4":{"apiToken":{"description":"Developer API token (asa_...), created by an organization owner in the dashboard.","scheme":"bearer","type":"http","scopes":[],"schemeName":"apiToken"}}},"servers":{"90eda533-3eea-4cba-b6d1-af6d4c026737":{"description":"Airship","url":"https://api.airshipci.com"},"01776530-a650-4ce7-9e3f-3c6271a8fed1":{"description":"A control plane you run yourself","url":"https://{host}","variables":{"host":{"default":"api.example.com"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Developer API token (asa_...), created by an organization owner in the dashboard.","scheme":"bearer","type":"http","scopes":[],"schemeName":"apiToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Developer API token (asa_...), created by an organization owner in the dashboard.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiToken","name":"Authorization"}],"title":"apiToken"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"airship","siteName":"Airship","title":"Connect a cloud - Airship","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T11:00:16.876Z","originalFileLocation":"api-reference/developer-api/connect-a-cloud.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=\"application-name\" content=\"Airship\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/airship/r1H-46EIl6lPe5hU/_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/airship/r1H-46EIl6lPe5hU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/airship/r1H-46EIl6lPe5hU/_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/airship/r1H-46EIl6lPe5hU/_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/airship/r1H-46EIl6lPe5hU/_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/airship/r1H-46EIl6lPe5hU/_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/airship/r1H-46EIl6lPe5hU/_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/airship/r1H-46EIl6lPe5hU/_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/airship/r1H-46EIl6lPe5hU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect a cloud - Airship\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Airship documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://airship.mintlify.app/api-reference/developer-api/connect-a-cloud\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://airship.mintlify.app/_mintlify/api/og/v2?division=Clouds\u0026amp;title=Connect+a+cloud\u0026amp;theme=40a1a36b85bc7353607e4049\u0026amp;signature=ebba7890397f748a5f9ecf085b8936e1c8506c816506fc8f46ba58092daee107\">\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=\"Connect a cloud - Airship\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://airship.mintlify.app/_mintlify/api/og/v2?division=Clouds\u0026amp;title=Connect+a+cloud\u0026amp;theme=40a1a36b85bc7353607e4049\u0026amp;signature=ebba7890397f748a5f9ecf085b8936e1c8506c816506fc8f46ba58092daee107\">\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/airship/r1H-46EIl6lPe5hU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Airship\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3064ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://airship.mintlify.app/api-reference/developer-api/connect-a-cloud\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/developer-api/connect-a-cloud.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://airship.mintlify.app/#organization\",\"name\":\"Airship\",\"url\":\"https://airship.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/airship/glanO3aKL9ONqfLd/logo/light.svg?fit=max\u0026auto=format\u0026n=glanO3aKL9ONqfLd\u0026q=85\u0026s=2fd1e7804f107307629dc88ce4da33f2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://airship.mintlify.app#website\",\"name\":\"Airship\",\"url\":\"https://airship.mintlify.app\",\"publisher\":{\"@id\":\"https://airship.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://airship.mintlify.app/api-reference/developer-api/connect-a-cloud#webpage\",\"url\":\"https://airship.mintlify.app/api-reference/developer-api/connect-a-cloud\",\"name\":\"Connect a cloud\",\"dateModified\":\"2026-10-28T11:00:16.876Z\",\"isPartOf\":{\"@id\":\"https://airship.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://airship.mintlify.app/api-reference/developer-api/connect-a-cloud#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://airship.mintlify.app/api-reference/developer-api/connect-a-cloud#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Clouds\",\"item\":\"https://airship.mintlify.app/api-reference/developer-api/list-connected-clouds\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect a cloud\",\"item\":\"https://airship.mintlify.app/api-reference/developer-api/connect-a-cloud\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://airship.mintlify.app/api-reference/developer-api/connect-a-cloud#apireference\",\"headline\":\"Connect a cloud\",\"name\":\"Connect a cloud\",\"url\":\"https://airship.mintlify.app/api-reference/developer-api/connect-a-cloud\",\"mainEntityOfPage\":{\"@id\":\"https://airship.mintlify.app/api-reference/developer-api/connect-a-cloud#webpage\"},\"dateModified\":\"2026-10-28T11:00:16.876Z\",\"publisher\":{\"@id\":\"https://airship.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://airship.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Airship\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Airship","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","icon":"terminal","groups":[{"group":"Developer API","pages":[{"title":"Developer API","sidebarTitle":"Overview","icon":"terminal","href":"/api-reference/introduction"}]},{"group":"Repositories","pages":[{"title":"List repositories","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/repo","href":"/api-reference/developer-api/list-repositories"},{"title":"Activate or deactivate a repository","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/repo","href":"/api-reference/developer-api/activate-or-deactivate-a-repository"}]},{"group":"Clouds","pages":[{"title":"List connected clouds","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/cloud-connect","href":"/api-reference/developer-api/list-connected-clouds"},{"title":"Connect a cloud","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/cloud-connect","href":"/api-reference/developer-api/connect-a-cloud"}]},{"group":"Access control","pages":[{"title":"Read access policies","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/access-control","href":"/api-reference/developer-api/read-access-policies"},{"title":"Change access policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/v1/access-control","href":"/api-reference/developer-api/change-access-policies"}]},{"group":"Runners","pages":[{"title":"Fetch a runner's boot script","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/runner-provision","href":"/api-reference/developer-api/fetch-a-runners-boot-script"}]}]}]},"title":"Connect a cloud - Airship","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}