Manage service accounts (Astro Private Cloud only).
This command is available only if you’re authenticated to an Astro Private Cloud installation.
Manage Deployment-level service accounts, which you can use to configure a CI/CD pipeline or otherwise interact with the Astronomer Houston API.
Usage
This command includes three subcommands: create, delete, and list
# Creates a Deployment-level service accountastro deployment service-account create --deployment-id=<your-deployment-id> --label=<your-service-account-label># Deletes a Deployment-level service accountastro deployment service-account delete <your-service-account-label># Shows the name, ID, and API token for each service account in a specific Deployment.astro deployment service-account list
Options
Option
Description
Possible Values
--category
The category for the new service account as displayed in the UI
Any string. The default value is default.
--deployment-id (Required for create and delete)
The Deployment you’re creating a service account for
Any Deployment ID
--label (Required for create)
The name or label for the new service account
Any string
--role
The User Role for the new service account
Can be either viewer, editor, or admin. The default is viewer.
Was this page helpful?
⌘I
{"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","download-pdf","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":""},"feedback":{"thumbs":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af767677b1d5fddacc82a31","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Astro CLI","count":3122},{"language":"default","tag":"CLI reference","count":1346},{"language":"default","tag":"Astro Private Cloud","count":1056},{"language":"default","tag":"Astro API","count":538},{"language":"default","tag":"Astro","count":534},{"language":"default","tag":"Airflow","count":508},{"language":"default","tag":"astro deployment","count":406},{"language":"default","tag":"astro workspace","count":210},{"language":"default","tag":"API Reference","count":181},{"language":"default","tag":"astro organization","count":180}],"searchSettings":{"maxResults":20,"isFiltersEnabled":true,"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","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":"cli/v1.40/astro-deployment-service-account","slug":"/cli/v1.40/astro-deployment-service-account","pageMetadata":{"title":"astro deployment service-account","description":"Manage service accounts (Astro Private Cloud only).","hideFooterPagination":true,"href":"/cli/v1.40/astro-deployment-service-account"},"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: \"Manage service accounts (Astro Private Cloud only).\"\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`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:`This command is available only if you’re authenticated to an Astro Private Cloud installation.`}),`\n`,_jsx(_components.p,{children:`Manage Deployment-level service accounts, which you can use to configure a CI/CD pipeline or otherwise interact with the Astronomer Houston API.`}),`\n`,_jsx(Heading,{level:`2`,id:`usage`,children:`Usage`}),`\n`,_jsxs(_components.p,{children:[`This command includes three subcommands: `,_jsx(_components.code,{children:`create`}),`, `,_jsx(_components.code,{children:`delete`}),`, and `,_jsx(_components.code,{children:`list`})]}),`\n`,_jsx(CodeBlock,{filename:``,wrap:`true`,numberOfLines:`8`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Creates a Deployment-level service account`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`astro`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` deployment`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` service-account`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --deployment-id=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`your-deployment-id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --label=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`your-service-account-label`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Deletes a Deployment-level service account`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`astro`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` deployment`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` service-account`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` delete`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`your-service-account-labe`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`l`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Shows the name, ID, and API token for each service account in a specific Deployment.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`astro`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` deployment`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` service-account`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`options`,children:`Options`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Possible Values`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--category`})}),_jsx(_components.td,{children:`The category for the new service account as displayed in the UI`}),_jsxs(_components.td,{children:[`Any string. The default value is `,_jsx(_components.code,{children:`default`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`--deployment-id`}),` (Required for `,_jsx(_components.code,{children:`create`}),` and `,_jsx(_components.code,{children:`delete`}),`)`]}),_jsx(_components.td,{children:`The Deployment you’re creating a service account for`}),_jsx(_components.td,{children:`Any Deployment ID`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`--label`}),` (Required for `,_jsx(_components.code,{children:`create`}),`)`]}),_jsx(_components.td,{children:`The name or label for the new service account`}),_jsx(_components.td,{children:`Any string`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--role`})}),_jsx(_components.td,{children:`The User Role for the new service account`}),_jsxs(_components.td,{children:[`Can be either `,_jsx(_components.code,{children:`viewer`}),`, `,_jsx(_components.code,{children:`editor`}),`, or `,_jsx(_components.code,{children:`admin`}),`. The default is `,_jsx(_components.code,{children:`viewer`}),`.`]})]})]})]})]})}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":"astro deployment service-account","description":"Manage service accounts (Astro Private Cloud only).","hideFooterPagination":true,"href":"/cli/v1.40/astro-deployment-service-account"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Usage","slug":"usage","depth":2,"children":[]},{"title":"Options","slug":"options","depth":2,"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":"astro deployment service-account - Astronomer","relatedPagesConfig":{"enabled":false,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{"v1.47":{"href":"/cli/v1.47/astro-deployment-service-account","matchLevel":1},"v1.46":{"href":"/cli/v1.46/astro-deployment-service-account","matchLevel":1},"v1.45":{"href":"/cli/v1.45/astro-deployment-service-account","matchLevel":1},"v1.44":{"href":"/cli/v1.44/astro-deployment-service-account","matchLevel":1},"v1.43":{"href":"/cli/v1.43/astro-deployment-service-account","matchLevel":1},"v1.42":{"href":"/cli/v1.42/astro-deployment-service-account","matchLevel":1},"v1.41":{"href":"/cli/v1.41/astro-deployment-service-account","matchLevel":1},"v1.40":{"href":"/cli/v1.40/astro-deployment-service-account","matchLevel":0},"v1.39":{"href":"/cli/v1.39/astro-deployment-service-account","matchLevel":1},"v1.38":{"href":"/cli/v1.38/astro-deployment-service-account","matchLevel":1},"v2.x":{"href":"/astro-private-cloud/v-2-x/astro-private-cloud-overview","matchLevel":4},"v1.x":{"href":"/astro-private-cloud/v-1-x/astro-private-cloud-overview","matchLevel":4},"v0.37":{"href":"/astro-private-cloud/v-0-37/software-overview","matchLevel":4},"v0.36":{"href":"/astro-private-cloud/v-0-36/overview-0.36","matchLevel":4},"v0.34":{"href":"/astro-private-cloud/v-0-34/overview-0.34","matchLevel":4},"Archive":{"href":"/astro-private-cloud/archive/documentation-archive","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-11-12T16:39:00.099Z","originalFileLocation":"cli/v1.40/astro-deployment-service-account.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=\"Manage service accounts (Astro Private Cloud only).\">\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=\"astro deployment service-account - Astronomer\">\u003cmeta data-mint-head property=\"og:description\" content=\"Manage service accounts (Astro Private Cloud only).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Astronomer Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.astronomer.io/docs/cli/v1.40/astro-deployment-service-account\">\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=\"astro deployment service-account - Astronomer\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Manage service accounts (Astro Private Cloud only).\">\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/cli/v1.40/astro-deployment-service-account\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/cli/v1.40/astro-deployment-service-account.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/cli/v1.40/astro-deployment-service-account#webpage\",\"url\":\"https://www.astronomer.io/docs/cli/v1.40/astro-deployment-service-account\",\"name\":\"astro deployment service-account\",\"description\":\"Manage service accounts (Astro Private Cloud only).\",\"dateModified\":\"2026-11-12T16:39:00.099Z\",\"isPartOf\":{\"@id\":\"https://www.astronomer.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.astronomer.io/docs/cli/v1.40/astro-deployment-service-account#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.astronomer.io/docs/cli/v1.40/astro-deployment-service-account#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Astro CLI\",\"item\":\"https://www.astronomer.io/docs/cli/v1.40/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"CLI reference\",\"item\":\"https://www.astronomer.io/docs/cli/v1.40/reference\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"astro deployment\",\"item\":\"https://www.astronomer.io/docs/cli/v1.40/astro-deployment\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"astro deployment service-account\",\"item\":\"https://www.astronomer.io/docs/cli/v1.40/astro-deployment-service-account\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://www.astronomer.io/docs/cli/v1.40/astro-deployment-service-account#article\",\"headline\":\"astro deployment service-account\",\"name\":\"astro deployment service-account\",\"description\":\"Manage service accounts (Astro Private Cloud only).\",\"url\":\"https://www.astronomer.io/docs/cli/v1.40/astro-deployment-service-account\",\"mainEntityOfPage\":{\"@id\":\"https://www.astronomer.io/docs/cli/v1.40/astro-deployment-service-account#webpage\"},\"image\":\"https://www.astronomer.io/docs/images/astronomer-card.png\",\"dateModified\":\"2026-11-12T16:39:00.099Z\",\"publisher\":{\"@id\":\"https://www.astronomer.io/#organization\"},\"isPartOf\":{\"@id\":\"https://www.astronomer.io/docs#website\"}}]}\u003c/script>","agentPointerHref":"/docs/cli/v1.40/astro-deployment-service-account.md","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"},{"version":"v1.x"},{"version":"v0.37"},{"version":"v0.36"},{"version":"v0.34"},{"version":"Archive"}],"pages":[{"title":"Astro Private Cloud","href":"/astro-private-cloud/v-2-x/astro-private-cloud-overview"}]},{"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","default":true,"pages":[{"title":"v1.47","href":"/cli/v1.47/astro-deployment-service-account"}]},{"version":"v1.46","pages":[{"title":"v1.46","href":"/cli/v1.46/astro-deployment-service-account"}]},{"version":"v1.45","pages":[{"title":"v1.45","href":"/cli/v1.45/astro-deployment-service-account"}]},{"version":"v1.44","tag":"deprecated","pages":[{"title":"v1.44","href":"/cli/v1.44/astro-deployment-service-account"}]},{"version":"v1.43","tag":"deprecated","pages":[{"title":"v1.43","href":"/cli/v1.43/astro-deployment-service-account"}]},{"version":"v1.42","tag":"deprecated","pages":[{"title":"v1.42","href":"/cli/v1.42/astro-deployment-service-account"}]},{"version":"v1.41","tag":"deprecated","pages":[{"title":"v1.41","href":"/cli/v1.41/astro-deployment-service-account"}]},{"version":"v1.40","tag":"deprecated","groups":[{"group":"Astro CLI","boost":0.1,"pages":[{"title":"Astro CLI","mode":"wide","href":"/cli/v1.40/overview"},{"title":"Get started with Airflow using the Astro CLI","sidebarTitle":"Quickstart","href":"/cli/v1.40/get-started-cli"},{"group":"CLI reference","pages":[{"title":"Astro CLI command reference","sidebarTitle":"Overview","href":"/cli/v1.40/reference"},{"title":"astro completion","href":"/cli/v1.40/astro-completion"},{"group":"astro api","root":{"title":"astro api","href":"/cli/v1.40/astro-api"},"pages":[{"title":"astro api airflow","href":"/cli/v1.40/astro-api-airflow"},{"title":"astro api cloud","href":"/cli/v1.40/astro-api-cloud"}]},{"group":"astro config","root":{"title":"astro config","href":"/cli/v1.40/astro-config"},"pages":[{"title":"astro config get","href":"/cli/v1.40/astro-config-get"},{"title":"astro config set","href":"/cli/v1.40/astro-config-set"}]},{"group":"astro context","root":{"title":"astro context","href":"/cli/v1.40/astro-context"},"pages":[{"title":"astro context delete","href":"/cli/v1.40/astro-context-delete"},{"title":"astro context list","href":"/cli/v1.40/astro-context-list"},{"title":"astro context switch","href":"/cli/v1.40/astro-context-switch"}]},{"group":"astro dbt","root":{"title":"astro dbt","href":"/cli/v1.40/astro-dbt"},"pages":[{"title":"astro dbt delete","href":"/cli/v1.40/astro-dbt-delete"},{"title":"astro dbt deploy","href":"/cli/v1.40/astro-dbt-deploy"}]},{"title":"astro deploy","href":"/cli/v1.40/astro-deploy"},{"group":"astro deployment","root":{"title":"astro deployment","href":"/cli/v1.40/astro-deployment"},"pages":[{"title":"astro deployment airflow upgrade","href":"/cli/v1.40/astro-deployment-airflow-upgrade"},{"group":"astro deployment airflow-variable","pages":[{"title":"astro deployment airflow-variable copy","href":"/cli/v1.40/astro-deployment-airflow-variable-copy"},{"title":"astro deployment airflow-variable create","href":"/cli/v1.40/astro-deployment-airflow-variable-create"},{"title":"astro deployment airflow-variable list","href":"/cli/v1.40/astro-deployment-airflow-variable-list"},{"title":"astro deployment airflow-variable update","href":"/cli/v1.40/astro-deployment-airflow-variable-update"}]},{"group":"astro deployment connection","pages":[{"title":"astro deployment connection copy","href":"/cli/v1.40/astro-deployment-connection-copy"},{"title":"astro deployment connection create","href":"/cli/v1.40/astro-deployment-connection-create"},{"title":"astro deployment connection list","href":"/cli/v1.40/astro-deployment-connection-list"},{"title":"astro deployment connection update","href":"/cli/v1.40/astro-deployment-connection-update"}]},{"group":"astro deployment pool","pages":[{"title":"astro deployment pool copy","href":"/cli/v1.40/astro-deployment-pool-copy"},{"title":"astro deployment pool create","href":"/cli/v1.40/astro-deployment-pool-create"},{"title":"astro deployment pool list","href":"/cli/v1.40/astro-deployment-pool-list"},{"title":"astro deployment pool update","href":"/cli/v1.40/astro-deployment-pool-update"}]},{"group":"astro deployment token","pages":[{"title":"astro deployment token create","href":"/cli/v1.40/astro-deployment-token-create"},{"title":"astro deployment token delete","href":"/cli/v1.40/astro-deployment-token-delete"},{"title":"astro deployment token list","href":"/cli/v1.40/astro-deployment-token-list"},{"title":"astro deployment token organization-token","href":"/cli/v1.40/astro-deployment-token-organization-token"},{"title":"astro deployment token rotate","href":"/cli/v1.40/astro-deployment-token-rotate"},{"title":"astro deployment token update","href":"/cli/v1.40/astro-deployment-token-update"},{"title":"astro deployment token workspace-token","href":"/cli/v1.40/astro-deployment-token-workspace-token"}]},{"group":"astro deployment variable","pages":[{"title":"astro deployment variable create","href":"/cli/v1.40/astro-deployment-variable-create"},{"title":"astro deployment variable list","href":"/cli/v1.40/astro-deployment-variable-list"},{"title":"astro deployment variable update","href":"/cli/v1.40/astro-deployment-variable-update"}]},{"group":"astro deployment worker-queue","pages":[{"title":"astro deployment worker-queue create","href":"/cli/v1.40/astro-deployment-worker-queue-create"},{"title":"astro deployment worker-queue delete","href":"/cli/v1.40/astro-deployment-worker-queue-delete"},{"title":"astro deployment worker-queue update","href":"/cli/v1.40/astro-deployment-worker-queue-update"}]},{"title":"astro deployment create","href":"/cli/v1.40/astro-deployment-create"},{"title":"astro deployment delete","href":"/cli/v1.40/astro-deployment-delete"},{"title":"astro deployment hibernate","href":"/cli/v1.40/astro-deployment-hibernate"},{"title":"astro deployment inspect","href":"/cli/v1.40/astro-deployment-inspect"},{"title":"astro deployment list","href":"/cli/v1.40/astro-deployment-list"},{"title":"astro deployment logs","href":"/cli/v1.40/astro-deployment-logs"},{"title":"astro deployment runtime migrate","href":"/cli/v1.40/astro-deployment-runtime-migrate"},{"title":"astro deployment runtime upgrade","description":"Upgrade a Deployment (Astro Private Cloud only).","href":"/cli/v1.40/astro-deployment-runtime-upgrade"},{"title":"astro deployment service-account","href":"/cli/v1.40/astro-deployment-service-account"},{"title":"astro deployment team","description":"Manage Deployment Teams.","href":"/cli/v1.40/astro-deployment-team"},{"title":"astro deployment update","href":"/cli/v1.40/astro-deployment-update"},{"title":"astro deployment user","href":"/cli/v1.40/astro-deployment-user"},{"title":"astro deployment wake-up","href":"/cli/v1.40/astro-deployment-wake-up"}]},{"group":"astro dev","root":{"title":"astro dev","href":"/cli/v1.40/astro-dev"},"pages":[{"title":"astro dev bash","href":"/cli/v1.40/astro-dev-bash"},{"title":"astro dev build","href":"/cli/v1.40/astro-dev-build"},{"title":"astro dev init","href":"/cli/v1.40/astro-dev-init"},{"title":"astro dev kill","href":"/cli/v1.40/astro-dev-kill"},{"title":"astro dev logs","href":"/cli/v1.40/astro-dev-logs"},{"title":"astro dev object export","href":"/cli/v1.40/astro-dev-object-export"},{"title":"astro dev object import","href":"/cli/v1.40/astro-dev-object-import"},{"title":"astro dev parse","href":"/cli/v1.40/astro-dev-parse"},{"title":"astro dev proxy","href":"/cli/v1.40/astro-dev-proxy"},{"title":"astro dev ps","href":"/cli/v1.40/astro-dev-ps"},{"title":"astro dev pytest","href":"/cli/v1.40/astro-dev-pytest"},{"title":"astro dev restart","href":"/cli/v1.40/astro-dev-restart"},{"title":"astro dev run","href":"/cli/v1.40/astro-dev-run"},{"title":"astro dev start","href":"/cli/v1.40/astro-dev-start"},{"title":"astro dev stop","href":"/cli/v1.40/astro-dev-stop"},{"title":"astro dev upgrade-test","href":"/cli/v1.40/astro-dev-upgrade-test"}]},{"group":"astro ide","root":{"title":"astro ide","href":"/cli/v1.40/astro-ide"},"pages":[{"title":"astro ide project export","href":"/cli/v1.40/astro-ide-project-export"},{"title":"astro ide project import","href":"/cli/v1.40/astro-ide-project-import"},{"title":"astro ide project list","href":"/cli/v1.40/astro-ide-project-list"}]},{"title":"astro login","href":"/cli/v1.40/astro-login"},{"title":"astro logout","href":"/cli/v1.40/astro-logout"},{"group":"astro organization","root":{"title":"astro organization","href":"/cli/v1.40/astro-organization"},"pages":[{"title":"astro organization audit-logs","href":"/cli/v1.40/astro-organization-audit-logs"},{"title":"astro organization list","href":"/cli/v1.40/astro-organization-list"},{"title":"astro organization switch","href":"/cli/v1.40/astro-organization-switch"},{"title":"astro organization role list","href":"/cli/v1.40/astro-organization-role-list"},{"title":"astro organization team create","href":"/cli/v1.40/astro-organization-team-create"},{"title":"astro organization team delete","href":"/cli/v1.40/astro-organization-team-delete"},{"title":"astro organization team list","href":"/cli/v1.40/astro-organization-team-list"},{"title":"astro organization team update","href":"/cli/v1.40/astro-organization-team-update"},{"title":"astro organization team user","href":"/cli/v1.40/astro-organization-team-user"},{"title":"astro organization token create","href":"/cli/v1.40/astro-organization-token-create"},{"title":"astro organization token delete","href":"/cli/v1.40/astro-organization-token-delete"},{"title":"astro organization token list","href":"/cli/v1.40/astro-organization-token-list"},{"title":"astro organization token roles","href":"/cli/v1.40/astro-organization-token-roles"},{"title":"astro organization token rotate","href":"/cli/v1.40/astro-organization-token-rotate"},{"title":"astro organization token update","href":"/cli/v1.40/astro-organization-token-update"},{"title":"astro organization user invite","href":"/cli/v1.40/astro-organization-user-invite"},{"title":"astro organization user list","href":"/cli/v1.40/astro-organization-user-list"},{"title":"astro organization user update","href":"/cli/v1.40/astro-organization-user-update"}]},{"title":"astro remote","href":"/cli/v1.40/astro-remote"},{"title":"astro run","href":"/cli/v1.40/astro-run"},{"title":"astro team","href":"/cli/v1.40/astro-team"},{"group":"astro telemetry","root":{"title":"astro telemetry","href":"/cli/v1.40/astro-telemetry"},"pages":[{"title":"astro telemetry disable","href":"/cli/v1.40/astro-telemetry-disable"},{"title":"astro telemetry enable","href":"/cli/v1.40/astro-telemetry-enable"}]},{"title":"astro user create","href":"/cli/v1.40/astro-user-create"},{"title":"astro version","href":"/cli/v1.40/astro-version"},{"group":"astro workspace","root":{"title":"astro workspace","href":"/cli/v1.40/astro-workspace"},"pages":[{"title":"astro workspace create","href":"/cli/v1.40/astro-workspace-create"},{"title":"astro workspace delete","href":"/cli/v1.40/astro-workspace-delete"},{"title":"astro workspace list","href":"/cli/v1.40/astro-workspace-list"},{"title":"astro workspace service-account","sidebarTitle":"astro workspace service account","href":"/cli/v1.40/astro-workspace-service-account"},{"title":"astro workspace switch","href":"/cli/v1.40/astro-workspace-switch"},{"title":"astro workspace team add","href":"/cli/v1.40/astro-workspace-team-add"},{"title":"astro workspace team list","href":"/cli/v1.40/astro-workspace-team-list"},{"title":"astro workspace team remove","href":"/cli/v1.40/astro-workspace-team-remove"},{"title":"astro workspace team update","href":"/cli/v1.40/astro-workspace-team-update"},{"title":"astro workspace token add","href":"/cli/v1.40/astro-workspace-token-add"},{"title":"astro workspace token create","href":"/cli/v1.40/astro-workspace-token-create"},{"title":"astro workspace token delete","href":"/cli/v1.40/astro-workspace-token-delete"},{"title":"astro workspace token list","href":"/cli/v1.40/astro-workspace-token-list"},{"title":"astro workspace token organization-token","href":"/cli/v1.40/astro-workspace-token-organization-token"},{"title":"astro workspace token rotate","href":"/cli/v1.40/astro-workspace-token-rotate"},{"title":"astro workspace token update","href":"/cli/v1.40/astro-workspace-token-update"},{"title":"astro workspace update","href":"/cli/v1.40/astro-workspace-update"},{"title":"astro workspace user add","href":"/cli/v1.40/astro-workspace-user-add"},{"title":"astro workspace user list","href":"/cli/v1.40/astro-workspace-user-list"},{"title":"astro workspace user remove","href":"/cli/v1.40/astro-workspace-user-remove"},{"title":"astro workspace user update","href":"/cli/v1.40/astro-workspace-user-update"}]}]},{"group":"Install the CLI","boost":0.1,"expanded":true,"pages":[{"title":"Install the Astro CLI","href":"/cli/v1.40/install-cli"},{"title":"Uninstall the Astro CLI","href":"/cli/v1.40/uninstall-cli"},{"title":"Upgrade the Astro CLI","href":"/cli/v1.40/upgrade-cli"},{"title":"Switch between Podman and Docker","href":"/cli/v1.40/switch-container-management"}]},{"group":"Develop with the CLI","boost":0.1,"expanded":true,"pages":[{"title":"Develop your Astro project","sidebarTitle":"Develop your project","href":"/cli/v1.40/develop-project"},{"group":"Add Airflow providers and packages","pages":[{"title":"Add Airflow providers, Python packages, and operating system packages","sidebarTitle":"Add Airflow providers, Python packages, and OS packages","href":"/cli/v1.40/add-providers-packages"},{"title":"Install Python packages from private sources","sidebarTitle":"Add Private Python packages","href":"/cli/v1.40/private-python-packages"}]},{"group":"Run Airflow locally","root":{"title":"Run Airflow locally","sidebarTitle":"Overview","href":"/cli/v1.40/local-airflow-overview"},"pages":[{"title":"Run your Astro project in a local Airflow environment with the CLI","sidebarTitle":"Basic setup","href":"/cli/v1.40/run-airflow-locally"},{"title":"Use Airflow connections hosted on Astro in a local environment","sidebarTitle":"Use Airflow connections from Astro","href":"/cli/v1.40/local-connections"},{"title":"Troubleshoot a local Airflow environment","sidebarTitle":"Troubleshoot a local environment","href":"/cli/v1.40/troubleshoot-locally"}]},{"title":"Test your Astro project","sidebarTitle":"Test your Dags","href":"/cli/v1.40/test-your-astro-project-locally"}]},{"group":"Configure the CLI","boost":0.1,"expanded":true,"pages":[{"title":"Configure the Astro CLI","sidebarTitle":"Overview","href":"/cli/v1.40/configure-cli"},{"title":"Podman for the Astro CLI","sidebarTitle":"Use Podman","href":"/cli/v1.40/use-podman"},{"title":"Customize your Astro project Dockerfile","sidebarTitle":"Customize your Dockerfile","href":"/cli/v1.40/customize-dockerfile"},{"group":"Authenticate to cloud services","root":{"title":"Authenticate to cloud services with user credentials","sidebarTitle":"Authenticate to cloud services","href":"/cli/v1.40/authenticate-to-clouds"},"pages":[{"title":"Authenticate Astro to AWS","sidebarTitle":"AWS","href":"/cli/v1.40/authenticate-to-aws"},{"title":"Authenticate Astro to GCP","sidebarTitle":"GCP","href":"/cli/v1.40/authenticate-to-gcp"},{"title":"Authenticate Astro to Azure","sidebarTitle":"Azure","href":"/cli/v1.40/authenticate-to-azure"}]},{"title":"Use `.airflowignore` to ignore files in your Astro project","sidebarTitle":"Ignore project files","href":"/cli/v1.40/airflowignore"}]},{"group":"Release information","boost":0.1,"expanded":true,"pages":[{"title":"Astro CLI release notes","sidebarTitle":"Release notes","href":"/cli/release-notes"},{"group":"Release notes archive","pages":[{"title":"Astro CLI release notes archive: 1.37 through 1.20","sidebarTitle":"Release notes: 1.37 to 1.20","href":"/cli/release-notes-archive-1"},{"title":"Astro CLI release notes archive: 1.19 through 1.10","sidebarTitle":"Release notes: 1.19 to 1.10","href":"/cli/release-notes-archive-2"},{"title":"Astro CLI release notes archive: 1.9 through 0.2","sidebarTitle":"Release notes: 1.9 to 0.2","href":"/cli/release-notes-archive-3"}]},{"title":"Astro CLI release and lifecycle policy","sidebarTitle":"Release and lifecycle policy","href":"/cli/v1.40/release-lifecycle-policy"}]},{"group":"Archived versions","boost":0.1,"expanded":true,"pages":[{"sidebarTitle":"Documentation archive","title":"Astro CLI documentation archive","href":"/cli/archive"}]}]}]},{"version":"v1.39","tag":"deprecated","pages":[{"title":"v1.39","href":"/cli/v1.39/astro-deployment-service-account"}]},{"version":"v1.38","tag":"deprecated","pages":[{"title":"v1.38","href":"/cli/v1.38/astro-deployment-service-account"}]}]},{"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":"astro deployment service-account - Astronomer","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":[],"chunks":[]}