Skip to main content

astro deployment pool update

Update the value for a Deployment's Airflow pool.


astro deployment airflow-pool update

To run this command in an automated process such as a CI/CD pipeline, set the following OS-level environment pools in a way that the Astro CLI can access them:


After setting the pools, this command works for a Deployment without you having to manually authenticate to Astronomer. Astronomer recommends storing ASTRONOMER_KEY_SECRET as a secret before using it to programmatically update production-level Deployments.


OptionDescriptionPossible Values
-d,--deployment-idThe ID of the Deployment where you want to create Airflow pools.Any valid Deployment ID
--deployment-nameThe name of the Deployment where you want to create Airflow pools. Use as an alternative to <deployment-id>.Any valid Deployment name
-w,--workspace-idCreate Airflow pools in a Deployment that is not in your current Workspace. If not specified, your current Workspace is assumed.Any valid Workspace ID
--nameThe Airflow pool name. Required.Any string
-v,--slotsNumber of airflow pool slots. Required.Any integer
--descriptionThe pool description.Any string


# update pool called my-pool stored in the Deployment with an ID of cl03oiq7d80402nwn7fsl3dmv
astro deployment pool update --deployment-id cl03oiq7d80402nwn7fsl3dmv --name my-pool --slots 10

# update pools stored in the Deployment "My Deployment"
astro deployment pool update --deployment-name="My Deployment" --name my-pool --slots 10

## Related Commands

- [`astro deployment pool create`](cli/
- [`astro deployment pool list`](cli/

Sign up for Developer Updates

Get a summary of new Astro features once a month.

You can unsubscribe at any time.
By proceeding you agree to our Privacy Policy, our Website Terms and to receive emails from Astronomer.