{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Astronomer","description":"Documentation for Astro, Astronomer's managed Apache Airflow platform, plus Astro Private Cloud, Astro Runtime, the Astro CLI, the Astro API, and Airflow learning guides.","colors":{"primary":"#6B3aad","light":"#c69dff","dark":"#6B3aad"},"logo":{"light":"https://mintcdn.com/astronomer/U_UZjTkJqgXPi7dz/images/logo-light.svg?fit=max\u0026auto=format\u0026n=U_UZjTkJqgXPi7dz\u0026q=85\u0026s=e0826571e784a49618fef3e33a90cb43","dark":"https://mintcdn.com/astronomer/U_UZjTkJqgXPi7dz/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=U_UZjTkJqgXPi7dz\u0026q=85\u0026s=365121f377a9f6fe6d4fc98a9c049287"},"favicon":"https://mintcdn.com/astronomer/Dj3lmYK-LeP4OB1k/images/favicon.svg?fit=max\u0026auto=format\u0026n=Dj3lmYK-LeP4OB1k\u0026q=85\u0026s=6d7f1fa50a345cb373b918c25b8afff3","api":{"openapi":{"source":"astro/api/v-1/openapi.yaml","directory":"astro/api/v-1/"}},"background":{"color":{"light":"#ffffff","dark":"#131426"}},"navbar":{"links":[{"href":"https://www.astronomer.io/product/","label":"Product"},{"href":"https://www.astronomer.io/customers/","label":"Customers"},{"href":"https://www.astronomer.io/events/webinars/","label":"Webinars"},{"href":"https://www.astronomer.io/pricing/","label":"Pricing"}],"primary":{"type":"button","label":"Get Started Free","href":"https://www.astronomer.io/lp/signup/"}},"footer":{"socials":{"github":"https://github.com/astronomer","linkedin":"https://www.linkedin.com/company/astronomer","youtube":"https://www.youtube.com/c/astronomer","x":"https://x.com/astronomerio"},"links":[{"header":"Product","items":[{"label":"Platform Overview","href":"https://www.astronomer.io/product"},{"label":"Astro Observe","href":"https://www.astronomer.io/product/observe"},{"label":"Astro Private Cloud","href":"https://www.astronomer.io/product/astro-private-cloud"},{"label":"Security \u0026 Trust","href":"https://www.astronomer.io/security"},{"label":"Pricing","href":"https://www.astronomer.io/pricing"},{"label":"Cosmos","href":"https://www.astronomer.io/cosmos"},{"label":"Professional Services","href":"https://www.astronomer.io/professional-services"}]},{"header":"Solutions","items":[{"label":"All Use Cases","href":"https://www.astronomer.io/solutions"},{"label":"AI Ops","href":"https://www.astronomer.io/solutions/ai-ml"},{"label":"Data Observability","href":"https://www.astronomer.io/solutions/data-observability"},{"label":"ETL/ELT","href":"https://www.astronomer.io/solutions/etl-elt"},{"label":"ML Ops","href":"https://www.astronomer.io/solutions/mlops"},{"label":"Financial Services","href":"https://www.astronomer.io/solutions/financial-services"},{"label":"Retail","href":"https://www.astronomer.io/solutions/retail-ecommerce"}]},{"header":"Resources","items":[{"label":"Academy","href":"https://academy.astronomer.io/"},{"label":"Blog","href":"https://www.astronomer.io/blog"},{"label":"Webinars","href":"https://www.astronomer.io/events/webinars"},{"label":"Events","href":"https://www.astronomer.io/events"},{"label":"What is Airflow","href":"https://www.astronomer.io/airflow"},{"label":"Airflow 3.0","href":"https://www.astronomer.io/airflow/3"},{"label":"Airflow 2.x End of Life","href":"https://www.astronomer.io/airflow-2-eol"}]},{"header":"Company","items":[{"label":"Our Story","href":"https://www.astronomer.io/about-us"},{"label":"Careers","href":"https://www.astronomer.io/careers"},{"label":"Contact","href":"https://www.astronomer.io/contact"},{"label":"Support","href":"https://support.astronomer.io/hc/en-us"},{"label":"Legal","href":"https://www.astronomer.io/legal"},{"label":"Privacy","href":"https://www.astronomer.io/privacy"},{"label":"Terms of Service","href":"https://www.astronomer.io/legal/terms-of-service"}]}]},"search":{"prompt":"Search Astronomer docs..."},"seo":{"metatags":{"canonical":"https://www.astronomer.io/docs","og:site_name":"Astronomer Documentation","og:image":"https://www.astronomer.io/docs/images/astronomer-card.png","twitter:card":"summary_large_image","twitter:image":"https://www.astronomer.io/docs/images/astronomer-card.png"},"organization":{"id":"https://www.astronomer.io/#organization","name":"Astronomer","legalName":"Astronomer, Inc.","url":"https://www.astronomer.io","sameAs":["https://github.com/astronomer","https://www.linkedin.com/company/astronomer/","https://x.com/astronomerio","https://www.youtube.com/c/astronomer"]}},"fonts":{"heading":{"family":"Albert Sans"},"body":{"family":"Inter"}},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"breadcrumbs","latex":false},"integrations":{"gtm":{"tagId":"GTM-WCJNSWTS"}},"contextual":{"options":["copy","chatgpt","claude","mcp"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"astronomer","hasAudioNarration":false,"actualSubdomain":"astronomer","customDomains":["astronomer.io"],"gitSource":{"type":"github","owner":"astronomer","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aecca879835a5a6cf912fda","collectionId":"3f116a97-de6d-4ad1-9eb7-58b55a8c7871","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aecca879835a5a6cf912fda"},"feedback":{"thumbs":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aee60b9a207f60029dc272d","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"Astro CLI","count":3122},{"language":"default","tag":"CLI reference","count":1346},{"language":"default","tag":"Astro Private Cloud","count":1014},{"language":"default","tag":"Astro","count":530},{"language":"default","tag":"Airflow","count":508},{"language":"default","tag":"Astro API","count":504},{"language":"default","tag":"astro deployment","count":406},{"language":"default","tag":"astro workspace","count":210},{"language":"default","tag":"astro organization","count":180},{"language":"default","tag":"Administration","count":167}],"searchSettings":{"maxResults":20,"isFiltersEnabled":true,"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"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":"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":"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":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":true},"customCss":[{"filePath":"custom/footer.css","content":"main{overflow-x:clip!important;border-radius:0!important}#footer{border-top:none!important;margin-left:calc(-1 * var(--main-padding-x, 0px))!important;margin-right:calc(-1 * var(--main-padding-x, 0px))!important}#footer a.select-none{display:none!important}#footer h2,#footer h3,#footer h4,#footer p.font-semibold,#footer p.text-sm.font-semibold{font-family:var(\n --theme-font-family-mono,\n \"Roboto Mono\",\n monospace\n )!important;font-size:12px!important;font-weight:700!important;letter-spacing:1px!important;text-transform:uppercase!important}"},{"filePath":"custom/header.css","content":":root{--mintlify-slot-header-height: 70px}@media (max-width: 1023px){:root{--mintlify-slot-header-height: 120px}}#navbar{background-color:var(--new-moon-90, #1d1d2c)!important;border:none!important;height:70px!important}#navbar .h-14{height:70px!important}@media (max-width: 1023px){#navbar,#navbar .h-14{height:60px!important}}#navbar .nav-logo[alt=\"light logo\"]{display:none!important}#navbar .nav-logo[alt=\"dark logo\"]{display:block!important;height:18px!important;width:auto!important}#navbar [data-component-part=\"products-selector-trigger\"]{color:var(--new-moon-10, #f0ece5)!important}#navbar [data-component-part=\"products-selector-trigger\"] span{color:var(--new-moon-10, #f0ece5)!important}#navbar [data-component-part=\"products-selector-trigger\"] svg[style*=\"mask-image\"]{background-color:var(--new-moon-10, #f0ece5)!important}#navbar [data-component-part=\"products-selector-trigger\"] svg:not([style*=\"mask-image\"]){color:var(--new-moon-50, #969194)!important}#navbar [data-component-part=\"products-selector-trigger\"]:hover,#navbar [data-component-part=\"products-selector-trigger\"]:focus-visible,#navbar [data-component-part=\"products-selector-trigger\"][aria-expanded=\"true\"]{background-color:var(--new-moon-80, #343247)!important;color:var(--new-moon-10, #f0ece5)!important}#navbar li.navbar-link{border:none!important;background:transparent!important;padding:0!important;border-radius:5px!important;display:inline-flex!important}#navbar li.navbar-link a{color:var(--new-moon-10, #f0ece5)!important;font-size:14px!important;font-weight:500!important;padding:4px 12px!important;border-radius:5px!important;transition:background-color 0.2s ease!important;text-decoration:none!important;opacity:1!important}#navbar li.navbar-link:hover,#navbar li.navbar-link a:hover,#navbar li.navbar-link a:focus{background-color:var(--new-moon-80, #343247)!important;opacity:1!important}#topbar-cta-button{display:inline-flex!important}#topbar-cta-button a{background-color:var(--gold-40, #ffb32d)!important;color:var(--new-moon-90, #1d1d2c)!important;border-radius:5px!important;padding:8px 20px!important;font-weight:600!important;font-size:14px!important;opacity:1!important;transition:background-color 0.2s ease!important}#topbar-cta-button a span{color:var(--new-moon-90, #1d1d2c)!important;font-weight:600!important;font-size:14px!important;opacity:1!important;line-height:2.14}#topbar-cta-button a:hover{background-color:var(--new-moon-20)!important;opacity:1!important}#search-bar-entry{padding-right:0.875rem;padding-left:0.65rem;padding-block:0}#search-bar-entry .truncate{font-size:12px}@media screen and (min-width: 1023px){a.select-none+div>button[type=\"button\"]{color:white!important}}#navbar.is-filled{box-shadow:0 2px 16px rgba(0, 0, 0, 0.4)}button.logout-link{color:var(--new-moon-10);margin-inline:0.5rem 1rem}@media screen and (max-width: 1023px){button.flex.items-center.h-14.py-4.px-5.lg\\:hidden.focus\\:outline-0.w-full.text-left{background:#f7f7f7}html.dark button.flex.items-center.h-14.py-4.px-5.lg\\:hidden.focus\\:outline-0.w-full.text-left{background:var(--new-moon-90)}}"},{"filePath":"custom/variables.css","content":":root{--main-padding-x: 1rem;--red-05: #fff2f3;--red-10: #ffe3e5;--red-20: #ffb6bb;--red-30: #ff929a;--red-40: #fd6d77;--red-50: #f03a47;--red-60: #c5283d;--red-70: #b4162b;--red-80: #9a0b1e;--red-90: #7b0011;--red-pink: #ed749d;--gold-05: #fffaf1;--gold-10: #fff1d8;--gold-20: #ffe3b3;--gold-30: #ffd07d;--gold-40: #ffb32d;--gold-50: #e89428;--gold-60: #dd8513;--gold-70: #c2730c;--gold-80: #a55d05;--gold-90: #7f4002;--gold-fg: #1b130a;--teal-05: #e3fbff;--teal-10: #c2f7ff;--teal-20: #95e8f5;--teal-30: #74d5e4;--teal-40: #44c9de;--teal-50: #13bdd7;--teal-60: #00a2bb;--teal-70: #0095ac;--teal-80: #008397;--teal-90: #006271;--green-05: #e6fff0;--green-10: #c4f9da;--green-20: #95f1ba;--green-30: #6bde99;--green-40: #42cc7a;--green-50: #19ba5a;--green-60: #118a06;--green-70: #0d7503;--green-80: #0a5702;--green-90: #053900;--blue-05: #f0f5ff;--blue-10: #d2e3ff;--blue-20: #adcbff;--blue-30: #81afff;--blue-40: #5493ff;--blue-50: #2676ff;--blue-60: #0458ea;--blue-70: #024bc9;--blue-80: #003da6;--blue-90: #00276a;--purple-05: #f7f3ff;--purple-10: #e8dbfe;--purple-20: #d9c2fe;--purple-30: #c9aafd;--purple-40: #ba91fc;--purple-50: #a067fb;--purple-60: #872ded;--purple-70: #6d23c0;--purple-80: #521993;--purple-90: #380e65;--purple-95: #1d0438;--purple-99: #0d011a;--new-moon-05: #f8f5f2;--new-moon-10: #f0ece5;--new-moon-20: #e9e2d8;--new-moon-30: #d0c9c2;--new-moon-40: #b6b1ad;--new-moon-50: #969194;--new-moon-60: #75727a;--new-moon-70: #555261;--new-moon-80: #343247;--new-moon-85: #2d2c3f;--new-moon-90: #1d1d2c;--new-moon-95: #111121;--new-moon-99: #040416;--topaz-50: #ffeee1;--topaz-100: #ffd9bd;--topaz-200: #ffc399;--topaz-300: #ff9d61;--topaz-400: #ff792e;--topaz-500: #d85d15;--topaz-600: #b14807;--topaz-700: #8a3700;--topaz-800: #632800;--white: #fff;--black: var(--new-moon-99);--surface-secondary: var(--grey-10);--theme-font-family-heading: \"League Gothic\", sans-serif;--theme-font-family-body: \"Roboto\", \"Inter\", sans-serif;--theme-font-family-mono: \"Roboto Mono\", monospace;--theme-font-family-condensed: \"Roboto Condensed\", \"Roboto\", sans-serif;--ease-standard: cubic-bezier(0.2, 0.8, 0.2, 1);--theme-primary-color: var(--new-moon-90);--theme-background-color: var(--white);--theme-accent-color: var(--gold-40);--theme-secondary-color: var(--new-moon-70)}@media (min-width: 800px){:root{--main-padding-x: 2rem}}@media (min-width: 1024px){:root{--main-padding-x: 2.5rem}}.card,.callout{border-radius:5px!important}.acds-button{--button-background-color: var(--gold-40, #ffb32d);--button-color: var(--new-moon-90, #1d1d2c);--button-background-color-hover: var(--new-moon-20);--button-color-hover: var(--new-moon-90, #1d1d2c);text-align:center;background:var(--button-background-color);color:var(--button-color);cursor:pointer;letter-spacing:0.2738px;border:3px solid var(--button-border-color);min-width:max-content;font-size:14px;font-style:normal;font-weight:600;line-height:2.14;font-family:var(--theme-font-family-body);border-radius:5px;padding:8px 20px;text-decoration:none;transition:all 0.3s;display:inline-block}.acds-button span{color:inherit!important}.acds-button svg{color:var(--new-moon-90, #1d1d2c);background-color:var(--new-moon-90, #1d1d2c)}.acds-button:hover{background-color:var(--button-background-color-hover, --new-moon-20);color:var(--button-color-hover, var(--button-color));text-decoration:none}.acds-button.secondary,.acds-button.secondary span{--button-background-color: var(--new-moon-70);--button-color: var(--white, #fff);--button-background-color-hover: var(--new-moon-90);--button-color-hover: var(--white, #fff);color:var(--button-color)!important}html.dark .acds-button:not(.secondary) span{color:var(--button-color)!important}#content-area{max-width:60rem!important}#content-container{padding-top:2rem;padding-inline:var(--main-padding-x)!important}#sidebar-content{padding-top:1rem}#sidebar-content>div>div.px-2{padding:0!important}#search-bar-entry,.sidebar-group button,.sidebar-group a{border-radius:5px!important}#page-context-menu-button{border-top-left-radius:5px;border-bottom-left-radius:5px}#page-context-menu-button+button{border-top-right-radius:5px;border-bottom-right-radius:5px}.eyebrow{font-family:var(--theme-font-family-mono);text-transform:uppercase;letter-spacing:0.1em;font-weight:600;font-size:12px;line-height:1.33}.scroll-mt-\\(--scroll-mt\\).almond-layout.top-\\[var\\(--mintlify-slot-header-height\\,7rem\\)\\].lg\\:top-\\[var\\(--mintlify-slot-header-height\\,3\\.5rem\\)\\].peer-\\[\\.is-not-custom\\]\\:fixed.peer-\\[\\.is-not-custom\\]\\:pb-2.peer-\\[\\.is-not-custom\\]\\:px-2.peer-\\[\\.is-not-custom\\]\\:pt-0.peer-\\[\\.is-custom\\]\\:absolute.peer-\\[\\.is-custom\\]\\:\\[\\\u0026\\>\\:first-child\\]\\:hidden\\!.peer-\\[\\.is-custom\\]\\:\\[\\\u0026\\>\\:first-child\\]\\:sm\\:hidden\\!.peer-\\[\\.is-custom\\]\\:\\[\\\u0026\\>\\:first-child\\]\\:md\\:hidden\\!.peer-\\[\\.is-custom\\]\\:\\[\\\u0026\\>\\:first-child\\]\\:lg\\:hidden\\!.peer-\\[\\.is-custom\\]\\:\\[\\\u0026\\>\\:first-child\\]\\:xl\\:hidden\\!{position:relative;padding-right:0;padding-bottom:0;width:100%!important}.flex.rounded-2xl.h-\\[calc\\(100dvh-1rem-var\\(--mintlify-slot-header-height\\,7rem\\)\\)\\].lg\\:h-\\[calc\\(100dvh-0\\.5rem-var\\(--mintlify-slot-header-height\\,3\\.5rem\\)\\)\\]{height:100%}#header>div:first-of-type+div p{margin-top:1rem;font-size:1rem;font-style:italic}.sticky.shrink-0.z-22.pt-2.pb-2.pr-2.mt-\\(--banner-height\\,0px\\).top-\\(--banner-height\\,0px\\).h-\\[calc\\(100vh-var\\(--banner-height\\,0px\\)\\)\\].print\\:hidden{padding:0;border-radius:0!important}#chat-assistant-sheet{border-radius:0}.flex.flex-col.sm\\:grid.max-md\\:grid-cols-2\\!.gap-8.flex-1{display:flex!important;justify-content:start;align-items:center;flex-wrap:wrap;flex-direction:row}.flex.flex-col.sm\\:grid.max-md\\:grid-cols-2\\!.gap-8.flex-1>div{flex:0 1 auto;max-width:min-content}@media screen and (max-width: 639px){.flex.flex-col.sm\\:grid.max-md\\:grid-cols-2\\!.gap-8.flex-1{align-items:start}.flex.flex-col.sm\\:grid.max-md\\:grid-cols-2\\!.gap-8.flex-1>div{flex:1 1 40%;max-width:none}}@media screen and (max-width: 1023px){.scroll-mt-\\(--scroll-mt\\).almond-layout.top-\\[var\\(--mintlify-slot-header-height\\,7rem\\)\\].lg\\:top-\\[var\\(--mintlify-slot-header-height\\,3\\.5rem\\)\\].peer-\\[\\.is-not-custom\\]\\:fixed.peer-\\[\\.is-not-custom\\]\\:pb-2.peer-\\[\\.is-not-custom\\]\\:px-2.peer-\\[\\.is-not-custom\\]\\:pt-0.peer-\\[\\.is-custom\\]\\:absolute.peer-\\[\\.is-custom\\]\\:\\[\\\u0026\\>\\:first-child\\]\\:hidden\\!.peer-\\[\\.is-custom\\]\\:\\[\\\u0026\\>\\:first-child\\]\\:sm\\:hidden\\!.peer-\\[\\.is-custom\\]\\:\\[\\\u0026\\>\\:first-child\\]\\:md\\:hidden\\!.peer-\\[\\.is-custom\\]\\:\\[\\\u0026\\>\\:first-child\\]\\:lg\\:hidden\\!.peer-\\[\\.is-custom\\]\\:\\[\\\u0026\\>\\:first-child\\]\\:xl\\:hidden\\!{padding-left:0}}"},{"filePath":"custom/home-search.css","content":".home-search-trigger{display:flex;align-items:center;gap:0.625rem;width:100%;padding:0.875rem 1.125rem;border:1px solid var(--new-moon-20, #e9e2d8);border-radius:8px;background:var(--white, #fff);color:var(--new-moon-50, #969194);font-family:var(--theme-font-family-body);font-size:15px;text-align:left;cursor:pointer;transition:border-color 0.2s ease,\n box-shadow 0.2s ease}.home-search-trigger:hover,.home-search-trigger:focus-visible{border-color:var(--new-moon-40, #b6b1ad);box-shadow:0 1px 4px rgba(0, 0, 0, 0.06);outline:none}.home-search-trigger svg{flex-shrink:0;color:var(--new-moon-50, #969194);background-color:var(--new-moon-50, #969194)}html.dark .home-search-trigger{background:var(--new-moon-85, #2d2c3f);border-color:var(--new-moon-80, #343247);color:var(--new-moon-40, #b6b1ad)}html.dark .home-search-trigger:hover,html.dark .home-search-trigger:focus-visible{border-color:var(--new-moon-60, #75727a)}"},{"filePath":"custom/sidebar.css","content":".sidebar-group-header{font-size:1rem;font-weight:600;color:var(--new-moon-90, #1d1d2c)}html.dark .sidebar-group-header{color:var(--new-moon-10, #f0ece5)}.sidebar-group>li[data-group-tag]{margin-top:0.75rem}.sidebar-group>li[data-group-tag]:first-child{margin-top:0.25rem}.sidebar-group>li[data-group-tag]>button{font-weight:600;color:var(--new-moon-90, #1d1d2c)}html.dark .sidebar-group>li[data-group-tag]>button{color:var(--new-moon-10, #f0ece5)}"}],"page":{"pagePath":"astro-private-cloud/v-1-x/houston-add-system-admin","slug":"/astro-private-cloud/v-1-x/houston-add-system-admin","pageMetadata":{"title":"Add a System Admin with the Houston API","sidebarTitle":"Add a System Admin","description":"Promote a user to System Admin on Astro Private Cloud using the Houston API.","hideFooterPagination":true,"href":"/astro-private-cloud/v-1-x/houston-add-system-admin"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Promote a user to System Admin on Astro Private Cloud using the Houston API.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`add-a-system-admin`,children:`Add a System Admin`}),`\n`,_jsx(_components.p,{children:`To add a user as a System Admin through the Houston API, you need the following values:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The user’s ID. To retrieve this, request the `,_jsx(_components.code,{children:`id`}),` value in a `,_jsx(_components.code,{children:`users`}),` query or run `,_jsx(_components.code,{children:`astro workspace user list`}),`.`]}),`\n`,_jsx(_components.li,{children:`System Admin permissions.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`You can then run the following query to add the user as a System Admin.`}),`\n`,_jsx(CodeBlock,{filename:``,wrap:`true`,numberOfLines:`11`,language:`graphql`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`graphql`,children:_jsxs(_components.code,{language:`graphql`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`mutation`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` createSystemRoleBinding`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` $userId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` = `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cuser-id>\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` $role`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`Role`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` SYSTEM_ADMIN`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` createSystemRoleBinding`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` userId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`$userId`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` role`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`$role`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ) {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` id`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Add a System Admin with the Houston API","sidebarTitle":"Add a System Admin","description":"Promote a user to System Admin on Astro Private Cloud using the Houston API.","hideFooterPagination":true,"href":"/astro-private-cloud/v-1-x/houston-add-system-admin"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Add a System Admin","slug":"add-a-system-admin","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/astronomer/46b6c05e40efd5a8/custom/footer-copyright.js","/docs/_mintlify/custom/astronomer/fdfd7818f1bab435/custom/header.js","/docs/_mintlify/custom/astronomer/15d4f032d5ffce84/custom/home-search.js"],"subdomain":"astronomer","siteName":"Astronomer","title":"Add a System Admin with the Houston API - Astronomer","relatedPagesConfig":{"enabled":false,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{"v2.x":{"href":"/astro-private-cloud/v-2-x/houston-add-system-admin","matchLevel":1},"v1.x":{"href":"/astro-private-cloud/v-1-x/houston-add-system-admin","matchLevel":0},"v0.37":{"href":"/astro-private-cloud/v-0-37/software-overview","matchLevel":2},"v0.36":{"href":"/astro-private-cloud/v-0-36/overview-0.36","matchLevel":2},"v0.34":{"href":"/astro-private-cloud/v-0-34/overview-0.34","matchLevel":2},"Archive":{"href":"/astro-private-cloud/archive/documentation-archive","matchLevel":2},"v1.47":{"href":"/cli/v1.47/overview","matchLevel":4},"v1.46":{"href":"/cli/v1.46/overview","matchLevel":4},"v1.45":{"href":"/cli/v1.45/overview","matchLevel":4},"v1.44":{"href":"/cli/v1.44/overview","matchLevel":4},"v1.43":{"href":"/cli/v1.43/overview","matchLevel":4},"v1.42":{"href":"/cli/v1.42/overview","matchLevel":4},"v1.41":{"href":"/cli/v1.41/overview","matchLevel":4},"v1.40":{"href":"/cli/v1.40/overview","matchLevel":4},"v1.39":{"href":"/cli/v1.39/overview","matchLevel":4},"v1.38":{"href":"/cli/v1.38/overview","matchLevel":4},"v1":{"href":"/astro/api/v-1/overview","matchLevel":4},"v1labs":{"href":"/astro/api/v-1-labs/labs-overview","matchLevel":4},"v1beta1":{"href":"/astro/api/v-1-beta-1/v1beta1-deprecation-notice","matchLevel":4},"Airflow 3":{"href":"/airflow/overview","matchLevel":4},"Airflow 2":{"href":"/airflow/2.x/overview","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-08-11T19:15:27.958Z","originalFileLocation":"astro-private-cloud/v-1-x/houston-add-system-admin.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=\"Promote a user to System Admin on Astro Private Cloud using the Houston API.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Astronomer\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/astronomer/qeNb2c1imgRQqBmD/_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=\"/docs/mintlify-assets/_mintlify/favicons/astronomer/qeNb2c1imgRQqBmD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/astronomer/qeNb2c1imgRQqBmD/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/astronomer/qeNb2c1imgRQqBmD/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/astronomer/qeNb2c1imgRQqBmD/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/astronomer/qeNb2c1imgRQqBmD/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/astronomer/qeNb2c1imgRQqBmD/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/astronomer/qeNb2c1imgRQqBmD/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/astronomer/qeNb2c1imgRQqBmD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add a System Admin with the Houston API - Astronomer\">\u003cmeta data-mint-head property=\"og:description\" content=\"Promote a user to System Admin on Astro Private Cloud using the Houston API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Astronomer Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-add-system-admin\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://www.astronomer.io/docs/images/astronomer-card.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=\"Add a System Admin with the Houston API - Astronomer\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Promote a user to System Admin on Astro Private Cloud using the Houston API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://www.astronomer.io/docs/images/astronomer-card.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=\"/docs/mintlify-assets/_mintlify/favicons/astronomer/qeNb2c1imgRQqBmD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Astronomer\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6B3aad\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-add-system-admin\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/astro-private-cloud/v-1-x/houston-add-system-admin.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.astronomer.io/#organization\",\"name\":\"Astronomer\",\"legalName\":\"Astronomer, Inc.\",\"url\":\"https://www.astronomer.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/astronomer/U_UZjTkJqgXPi7dz/images/logo-light.svg?fit=max\u0026auto=format\u0026n=U_UZjTkJqgXPi7dz\u0026q=85\u0026s=e0826571e784a49618fef3e33a90cb43\"},\"sameAs\":[\"https://github.com/astronomer\",\"https://www.linkedin.com/company/astronomer/\",\"https://x.com/astronomerio\",\"https://www.youtube.com/c/astronomer\"]},{\"@type\":\"WebSite\",\"@id\":\"https://www.astronomer.io/docs#website\",\"name\":\"Astronomer\",\"url\":\"https://www.astronomer.io/docs\",\"publisher\":{\"@id\":\"https://www.astronomer.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-add-system-admin#webpage\",\"url\":\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-add-system-admin\",\"name\":\"Add a System Admin with the Houston API\",\"description\":\"Promote a user to System Admin on Astro Private Cloud using the Houston API.\",\"dateModified\":\"2026-08-11T19:15:27.958Z\",\"isPartOf\":{\"@id\":\"https://www.astronomer.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-add-system-admin#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-add-system-admin#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Astro Private Cloud\",\"item\":\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/astro-private-cloud-overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Houston API\",\"item\":\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-api\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Example mutations\",\"item\":\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-upsert-deployment\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Add a System Admin with the Houston API\",\"item\":\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-add-system-admin\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-add-system-admin#article\",\"headline\":\"Add a System Admin with the Houston API\",\"name\":\"Add a System Admin with the Houston API\",\"description\":\"Promote a user to System Admin on Astro Private Cloud using the Houston API.\",\"url\":\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-add-system-admin\",\"mainEntityOfPage\":{\"@id\":\"https://www.astronomer.io/docs/astro-private-cloud/v-1-x/houston-add-system-admin#webpage\"},\"image\":\"https://www.astronomer.io/docs/images/astronomer-card.png\",\"dateModified\":\"2026-08-11T19:15:27.958Z\",\"publisher\":{\"@id\":\"https://www.astronomer.io/#organization\"},\"isPartOf\":{\"@id\":\"https://www.astronomer.io/docs#website\"}}]}\u003c/script>","siteName":"Astronomer","nav":{"global":null,"products":[{"product":"Home","icon":"house","pages":[{"title":"Home","href":""}]},{"product":"Astro","icon":"rocket","description":"Fully managed Apache Airflow from experts.","pages":[{"title":"Astro","href":"/astro/overview"}]},{"product":"Astro Private Cloud","icon":"clouds","description":"A better way to manage Apache Airflow yourself.","versions":[{"version":"v2.x","default":true,"pages":[{"title":"v2.x","href":"/astro-private-cloud/v-2-x/houston-add-system-admin"}]},{"version":"v1.x","groups":[{"group":"Astro Private Cloud","pages":[{"title":"Astro Private Cloud documentation","sidebarTitle":"Astro Private Cloud overview","mode":"wide","href":"/astro-private-cloud/v-1-x/astro-private-cloud-overview"},{"title":"Astro Private Cloud features","href":"/astro-private-cloud/v-1-x/apc-features"},{"group":"Architecture","expanded":true,"pages":[{"title":"Astro Private Cloud control plane architecture","sidebarTitle":"Control plane architecture","href":"/astro-private-cloud/v-1-x/control-plane-architecture"},{"title":"Astro Private Cloud data plane architecture","sidebarTitle":"Data plane architecture","href":"/astro-private-cloud/v-1-x/data-plane-architecture"},{"title":"Astro Private Cloud unified architecture","sidebarTitle":"Unified architecture","href":"/astro-private-cloud/v-1-x/unified-architecture"}]},{"group":"Upgrade to Astro Private Cloud","expanded":true,"pages":[{"title":"Breaking changes and removals","href":"/astro-private-cloud/v-1-x/breaking-changes-removals"},{"title":"Upgrade to Astro Private Cloud 1.0 from 0.37","sidebarTitle":"Upgrade to 1.0","href":"/astro-private-cloud/v-1-x/upgrade-037-to-1"},{"title":"Debug an Astro Private Cloud upgrade","sidebarTitle":"Debug upgrade","href":"/astro-private-cloud/v-1-x/debug-upgrade"}]},{"group":"Install Astro Private Cloud","expanded":true,"pages":[{"title":"Plan Your Astro Private Cloud Installation","sidebarTitle":"Install overview","href":"/astro-private-cloud/v-1-x/install-overview"},{"title":"Install the Astro Private Cloud Control Plane","sidebarTitle":"Install the control plane","href":"/astro-private-cloud/v-1-x/install-control-plane"},{"title":"Install the Astro Private Cloud data plane","sidebarTitle":"Install a data plane","href":"/astro-private-cloud/v-1-x/install-data-plane"},{"title":"Install Astro Private Cloud in unified mode","sidebarTitle":"Install in unified mode","href":"/astro-private-cloud/v-1-x/install-unified"},{"group":"Customize your installation","pages":[{"title":"Merge yaml configurations","href":"/astro-private-cloud/v-1-x/merge-yaml"},{"title":"Add certificate authorities (CAs) to Docker Desktop","sidebarTitle":"Add trusted certificate authorities (CAs)","href":"/astro-private-cloud/v-1-x/configure-desktop-container-solution-extra-cas"},{"title":"Disable outbound email","href":"/astro-private-cloud/v-1-x/disable-outbound-email"},{"title":"Trust private certificate authorities (CAs)","sidebarTitle":"Trust private certificate authorities","href":"/astro-private-cloud/v-1-x/configure-private-cas"},{"title":"Disable management of quotas and limitranges","sidebarTitle":"Disable managing quotas and limitranges","href":"/astro-private-cloud/v-1-x/disable-quotas-limitranges"}]},{"group":"Troubleshoot","pages":[{"title":"Debug an Astro Private Cloud installation","sidebarTitle":"Debug an installation","href":"/astro-private-cloud/v-1-x/debug-install"}]},{"sidebarTitle":"Log in to Astro Private Cloud","title":"Log in to Astro Private Cloud","href":"/astro-private-cloud/v-1-x/log-in-to-private-cloud"}]},{"group":"Develop Dags","expanded":true,"pages":[{"sidebarTitle":"Set environment variables","title":"Set environment variables on Astro Private Cloud","href":"/astro-private-cloud/v-1-x/environment-variables"},{"title":"Run the KubernetesPodOperator on Astro Private Cloud","sidebarTitle":"Use the KubernetesPodOperator","href":"/astro-private-cloud/v-1-x/kube-pod-operator"},{"title":"Run the Kubernetes executor on Astro Private Cloud","sidebarTitle":"Use the Kubernetes Executor","href":"/astro-private-cloud/v-1-x/kubernetes-executor"}]},{"group":"Airflow administration","expanded":true,"pages":[{"group":"Work with the Airflow database","pages":[{"title":"Database architecture","href":"/astro-private-cloud/v-1-x/database-architecture"},{"title":"Database connection behavior reference","href":"/astro-private-cloud/v-1-x/database-behavior-reference"},{"title":"Access Airflow database","sidebarTitle":"Access the Airflow database","href":"/astro-private-cloud/v-1-x/access-airflow-database"},{"title":"Use a MySQL or PostgreSQL database for metadata or storage","sidebarTitle":"Bring your own Airflow database","href":"/astro-private-cloud/v-1-x/multi-db"},{"title":"Backfill permissions","href":"/astro-private-cloud/v-1-x/backfill-permissions"}]}]},{"group":"Airflow 3","expanded":true,"pages":[{"sidebarTitle":"Airflow 3 features","title":"Airflow 3 New Features","href":"/astro-private-cloud/v-1-x/af3-features"},{"title":"Migrate to Airflow 3 from Airflow 2 in Astro Private Cloud","sidebarTitle":"Migrate to Airflow 3","href":"/astro-private-cloud/v-1-x/migrate-to-airflow-3"}]},{"group":"Deploy Dags","expanded":true,"pages":[{"title":"Deploy code overview","sidebarTitle":"Overview","href":"/astro-private-cloud/v-1-x/deploy-code-overview"},{"sidebarTitle":"Deploy Dags using the CLI","title":"Deploy Dags to Astro Private Cloud using the Astro CLI","href":"/astro-private-cloud/v-1-x/deploy-dags"},{"title":"Configure CI/CD on Astro Private Cloud","sidebarTitle":"CI/CD","href":"/astro-private-cloud/v-1-x/ci-cd"},{"sidebarTitle":"Configure git-sync deploys","title":"Configure git-sync code deploys","href":"/astro-private-cloud/v-1-x/deploy-git-sync"},{"title":"Deploy Dags with NFS","href":"/astro-private-cloud/v-1-x/deploy-nfs"},{"sidebarTitle":"Rollback a code deploy","title":"Roll back an image deploy on Astro Private Cloud","href":"/astro-private-cloud/v-1-x/deploy-rollbacks"}]},{"group":"Manage Deployments","expanded":true,"pages":[{"group":"Create and update Deployments","pages":[{"sidebarTitle":"Overview","title":"Configure a Deployment on Astro Private Cloud","href":"/astro-private-cloud/v-1-x/configure-deployment"},{"sidebarTitle":"Create in the UI","title":"Create a Deployment on Astro Private Cloud from the UI","href":"/astro-private-cloud/v-1-x/create-deployment-ui"},{"sidebarTitle":"Programmatically upsert Deployments","title":"Programmatically create or update Deployments on Astro Private Cloud","href":"/astro-private-cloud/v-1-x/create-deployment-programmatic"},{"sidebarTitle":"Customize release names","title":"Customize Deployment release names","href":"/astro-private-cloud/v-1-x/customize-deployment-releases-name"},{"sidebarTitle":"Create using Astro Runtime SHA","title":"Create Deployments using Astro Runtime SHA256 digest","href":"/astro-private-cloud/v-1-x/create-deployment-sha"}]},{"sidebarTitle":"Scale Deployment resources","title":"Configure resources for Airflow components on Astro Private Cloud Deployments","href":"/astro-private-cloud/v-1-x/scale-deployment-resources"},{"title":"Scale Airflow resources","href":"/astro-private-cloud/v-1-x/scale-airflow-resources"},{"sidebarTitle":"Configure Deployment resources","title":"Customize Deployment CPU and management resources per component","href":"/astro-private-cloud/v-1-x/customize-resource-usage"},{"sidebarTitle":"Clean up and delete task metadata","title":"Clean up and delete task metadata from Airflow DB","href":"/astro-private-cloud/v-1-x/clean-up-task-metadata"},{"title":"Ephemeral storage configuration","href":"/astro-private-cloud/v-1-x/ephemeral-storage"}]},{"group":"Platform administration","expanded":true,"pages":[{"title":"Manage Workspaces and Deployments on Astronomer","sidebarTitle":"Manage Workspaces","href":"/astro-private-cloud/v-1-x/manage-workspaces"},{"title":"Create a service account","href":"/astro-private-cloud/v-1-x/create-service-account"},{"title":"Configure Astro Private Cloud","sidebarTitle":"Config governance","href":"/astro-private-cloud/v-1-x/configure-astro-private-cloud"},{"title":"Apply an Astro Private Cloud platform Helm configuration change","sidebarTitle":"Apply a config change","href":"/astro-private-cloud/v-1-x/apply-platform-config"},{"title":"Configure cleanup jobs","href":"/astro-private-cloud/v-1-x/cleanup-cronjobs"},{"sidebarTitle":"Use kubectl","title":"Use kubectl to administer Astro Private Cloud","href":"/astro-private-cloud/v-1-x/kubectl"},{"group":"Manage data plane clusters","pages":[{"title":"Data plane clusters in Astro Private Cloud","sidebarTitle":"Data plane cluster overview","href":"/astro-private-cloud/v-1-x/overview-data-plane-cluster"},{"title":"Register a data plane cluster","sidebarTitle":"Register a data plane","href":"/astro-private-cloud/v-1-x/register-data-plane"},{"title":"Deregister a data plane cluster","sidebarTitle":"Deregister a data plane cluster","href":"/astro-private-cloud/v-1-x/deregister-data-plane"},{"title":"Override data plane cluster configurations","sidebarTitle":"Update data plane cluster configurations","href":"/astro-private-cloud/v-1-x/override-data-plane-cluster"},{"title":"Manage cluster status","href":"/astro-private-cloud/v-1-x/cluster-status-management"},{"title":"Troubleshoot data plane registration","sidebarTitle":"Troubleshoot registration","href":"/astro-private-cloud/v-1-x/troubleshoot-data-plane-registration"}]},{"group":"Components","pages":[{"title":"Airflow system components","href":"/astro-private-cloud/v-1-x/airflow-system-components"}]}]},{"group":"Manage Platform resources","expanded":true,"pages":[{"title":"Using external registry backends in Astro Private Cloud","sidebarTitle":"Use a registry backend","href":"/astro-private-cloud/v-1-x/registry-backend"},{"title":"Configure a Kubernetes namespace pool for Astro Private Cloud","sidebarTitle":"Configure namespace pools","href":"/astro-private-cloud/v-1-x/namespace-pools"},{"title":"Configure platform resources","href":"/astro-private-cloud/v-1-x/configure-platform-resources"},{"sidebarTitle":"Configure component size limits","title":"Configure component size limits","href":"/astro-private-cloud/v-1-x/configure-component-size-limits"},{"title":"Overprovision Airflow components","href":"/astro-private-cloud/v-1-x/overprovision-components"},{"sidebarTitle":"Add Pod labels","title":"Add labels to Pods created by the Astro Private Cloud Helm chart","href":"/astro-private-cloud/v-1-x/add-podlabels"},{"group":"User access and management","pages":[{"title":"Manage users on Astro Private Cloud","sidebarTitle":"Manage users","href":"/astro-private-cloud/v-1-x/manage-platform-users"},{"title":"Manage user permissions on Astro Private Cloud","sidebarTitle":"User permissions","href":"/astro-private-cloud/v-1-x/manage-permissions"},{"sidebarTitle":"Import identity provider (IdP) groups","title":"Import identity provider groups into Astro Private Cloud","href":"/astro-private-cloud/v-1-x/import-idp-groups"},{"title":"Manage teams via API","sidebarTitle":"Manage teams","href":"/astro-private-cloud/v-1-x/team-management-api"},{"sidebarTitle":"Configure authentication system","title":"Configure authentication and configure an identity provider on Astro Private Cloud","href":"/astro-private-cloud/v-1-x/integrate-auth-system"},{"sidebarTitle":"Integrate IAM roles","title":"Integrate IAM roles on Astro Private Cloud","href":"/astro-private-cloud/v-1-x/integrate-iam"}]},{"group":"Configure platform registry","pages":[{"title":"Configure a custom registry for Deployment images","sidebarTitle":"Configure custom image registry","href":"/astro-private-cloud/v-1-x/custom-image-registry"}]}]},{"group":"Security and compliance","expanded":true,"pages":[{"group":"Configure a secrets backend","root":{"title":"Configure an external secrets backend on Astro Private Cloud","sidebarTitle":"Configure a secrets backend","href":"/astro-private-cloud/v-1-x/secrets-backend"},"pages":[{"title":"Configure a Hashicorp Vault secrets backend on Astro Private Cloud","sidebarTitle":"Hashicorp Vault","href":"/astro-private-cloud/v-1-x/secrets-backend-hashicorp"},{"title":"Configure AWS Secrets Manager as a secrets backend on Astro Private Cloud","sidebarTitle":"AWS Secrets Manager","href":"/astro-private-cloud/v-1-x/secrets-backend-aws-secrets-manager"},{"title":"Configure AWS Parameter Store as a secrets backend on Astro Private Cloud","sidebarTitle":"AWS Parameter Store","href":"/astro-private-cloud/v-1-x/secrets-backend-aws-parameter-store"},{"title":"Configure Google Cloud Secret Manager as a secrets backend on Astro Private Cloud","sidebarTitle":"Google Cloud Secret Manager","href":"/astro-private-cloud/v-1-x/secrets-backend-gcp"},{"title":"Configure Azure Key Vault as a secrets backend on Astro Private Cloud","sidebarTitle":"Azure Key Vault","href":"/astro-private-cloud/v-1-x/secrets-backend-azure"}]},{"title":"Configure Kerberos authentication for Airflow databases","sidebarTitle":"Configure Kerberos database authentication","href":"/astro-private-cloud/v-1-x/kerberos-database-setup"},{"title":"Use a third-party ingress controller","sidebarTitle":"Third-party ingress controllers","href":"/astro-private-cloud/v-1-x/third-party-ingress-controllers"},{"title":"Network configuration","href":"/astro-private-cloud/v-1-x/network-configuration"},{"title":"Bring your own Kubernetes service accounts","sidebarTitle":"Bring your own service accounts","href":"/astro-private-cloud/v-1-x/byo-service-accounts"},{"sidebarTitle":"Configure security contexts","title":"Configure Pod security contexts","href":"/astro-private-cloud/v-1-x/configure-securitycontext"},{"title":"Read-only root filesystem","sidebarTitle":"Read-only root filesystem","href":"/astro-private-cloud/v-1-x/read-only-root-filesystem"},{"title":"TLS certificate management","href":"/astro-private-cloud/v-1-x/tls-certificates"},{"title":"Respond to Airflow database credentials in APC logs","sidebarTitle":"Database credentials in logs","href":"/astro-private-cloud/v-1-x/database-credentials-in-logs"}]},{"group":"Houston API","expanded":true,"pages":[{"title":"Use the Houston API on Astro Private Cloud","sidebarTitle":"Overview","href":"/astro-private-cloud/v-1-x/houston-api"},{"title":"Authenticate to the Houston API","sidebarTitle":"Authenticate","href":"/astro-private-cloud/v-1-x/houston-api-authenticate"},{"title":"Develop and test Houston API queries","sidebarTitle":"Develop and test queries","href":"/astro-private-cloud/v-1-x/houston-api-develop-test"},{"title":"Example Houston API queries","sidebarTitle":"Example Queries","href":"/astro-private-cloud/v-1-x/houston-api-example-queries"},{"group":"Example mutations","pages":[{"title":"Upsert a Deployment with the Houston API","sidebarTitle":"Upsert Deployment","href":"/astro-private-cloud/v-1-x/houston-upsert-deployment"},{"title":"Delete a Deployment with the Houston API","sidebarTitle":"Delete Deployment","href":"/astro-private-cloud/v-1-x/houston-delete-deployment"},{"title":"Create a Deployment user with the Houston API","sidebarTitle":"Create Deployment user","href":"/astro-private-cloud/v-1-x/houston-create-deployment-user"},{"title":"Delete a user with the Houston API","sidebarTitle":"Delete user","href":"/astro-private-cloud/v-1-x/houston-delete-user"},{"title":"Verify user email with the Houston API","sidebarTitle":"Verify user email","href":"/astro-private-cloud/v-1-x/houston-verify-user-email"},{"title":"Bypass user email verification with the Houston API","sidebarTitle":"Bypass user email verification","description":"Bypass email verification when adding users to a Workspace via the Houston API.","href":"/astro-private-cloud/v-1-x/houston-bypass-user-email-verification"},{"title":"Add a System Admin with the Houston API","sidebarTitle":"Add a System Admin","href":"/astro-private-cloud/v-1-x/houston-add-system-admin"},{"title":"Create a System Service Account Token with the Houston API","sidebarTitle":"Create System Service Account Token","description":"Create a System Service Account token for CI/CD integrations via the Houston API.","href":"/astro-private-cloud/v-1-x/houston-create-system-service-account-token"},{"title":"Update environment variables with the Houston API","sidebarTitle":"Update environment variables","href":"/astro-private-cloud/v-1-x/houston-update-environment-variables"}]}]},{"group":"Platform Observability","expanded":true,"pages":[{"title":"Configure metrics","href":"/astro-private-cloud/v-1-x/configure-metrics"},{"title":"Configure probes","sidebarTitle":"Configure liveness and readiness probes","href":"/astro-private-cloud/v-1-x/configure-probes"},{"sidebarTitle":"Forward logs to Amazon S3","title":"Forward logs to Amazon S3","href":"/astro-private-cloud/v-1-x/logs-to-s3"},{"title":"Platform and deployment alerts","sidebarTitle":"Platform and deployment alerts","href":"/astro-private-cloud/v-1-x/platform-alerts"},{"title":"Logs configuration","href":"/astro-private-cloud/v-1-x/logs-configuration"},{"title":"Manage Elasticsearch log indices","sidebarTitle":"Elasticsearch indices","href":"/astro-private-cloud/v-1-x/manage-elasticsearch-indices"},{"sidebarTitle":"Export task logs","title":"Configure task log collection and exporting to ElasticSearch","href":"/astro-private-cloud/v-1-x/export-task-logs"}]},{"group":"Release notes","expanded":true,"pages":[{"title":"Astro Private Cloud release notes","sidebarTitle":"Astro Private Cloud","href":"/astro-private-cloud/v-1-x/release-notes"},{"title":"Subscribe to Astro Private Cloud release notes","sidebarTitle":"Subscribe","href":"/astro-private-cloud/v-1-x/release-notes-subscribe"}]},{"group":"Version compatibility","expanded":true,"pages":[{"title":"Version compatibility reference for Astro Private Cloud","sidebarTitle":"Astro Private Cloud supported versions","href":"/astro-private-cloud/v-1-x/version-compatibility-reference"},{"title":"Kubernetes version support table and policy","sidebarTitle":"Kubernetes support","href":"/astro-private-cloud/v-1-x/kubernetes-version-support"},{"title":"Airflow chart compatibility reference for Astro Private Cloud","sidebarTitle":"Airflow chart compatibility","href":"/astro-private-cloud/v-1-x/airflow-chart-compatibility"}]},{"group":"Reference","expanded":true,"pages":[{"title":"Helm configuration reference","href":"/astro-private-cloud/v-1-x/helm-config-reference"},{"title":"Container image reference","href":"/astro-private-cloud/v-1-x/container-image-reference"},{"title":"Astro Private Cloud user role and permission reference","sidebarTitle":"User roles and permissions","href":"/astro-private-cloud/v-1-x/role-permission-reference"},{"title":"Astro Private Cloud release and lifecycle policy","sidebarTitle":"Release and lifecycle policy","href":"/astro-private-cloud/v-1-x/release-lifecycle-policy"},{"title":"Submit a support request","sidebarTitle":"Support policy","href":"/astro-private-cloud/v-1-x/support"}]}]}]},{"version":"v0.37","tag":"deprecated","pages":[{"title":"v0.37","href":"/astro-private-cloud/v-0-37/software-overview"}]},{"version":"v0.36","tag":"deprecated","pages":[{"title":"v0.36","href":"/astro-private-cloud/v-0-36/overview-0.36"}]},{"version":"v0.34","tag":"deprecated","pages":[{"title":"v0.34","href":"/astro-private-cloud/v-0-34/overview-0.34"}]},{"version":"Archive","tag":"deprecated","pages":[{"title":"Archive","href":"/astro-private-cloud/archive/documentation-archive"}]}]},{"product":"Astro Runtime","icon":"layer-group","description":"The distribution of Apache Airflow that powers Astro.","pages":[{"title":"Astro Runtime","href":"/runtime/overview"}]},{"product":"Astro CLI","icon":"terminal","description":"Manage and configure your Astro projects.","versions":[{"version":"v1.47"},{"version":"v1.46"},{"version":"v1.45"},{"version":"v1.44"},{"version":"v1.43"},{"version":"v1.42"},{"version":"v1.41"},{"version":"v1.40"},{"version":"v1.39"},{"version":"v1.38"}],"pages":[{"title":"Astro CLI","href":"/cli/v1.47/overview"}]},{"product":"Astro API","icon":"gear-code","description":"Programmatic control of Astro resources and Airflow operations.","versions":[{"version":"v1"},{"version":"v1labs"},{"version":"v1beta1"}],"pages":[{"title":"Astro API","href":"/astro/api/v-1/overview"}]},{"product":"Airflow","icon":"books","description":"Apache Airflow tutorials, concepts, and guides.","versions":[{"version":"Airflow 3"},{"version":"Airflow 2"}],"pages":[{"title":"Airflow","href":"/airflow/overview"}]}]},"basePath":"","title":"Add a System Admin with the Houston API - Astronomer","buildId":"dpl_ATnXPMW25DMPUr9VBw6kL6MfBt6T","deploymentId":"dpl_ATnXPMW25DMPUr9VBw6kL6MfBt6T","dynamics":[],"chunks":[]}