> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Programmatically create or update Deployments on Astro Private Cloud

You can programmatically create or update Deployments with all possible configurations using the APC API `upsertDeployment` mutation.

<Warning>
  When you make upsert updates to your Airflow Deployments, you must explicitly specify all existing environment variables, otherwise, the upsert overwrites them.
</Warning>

For a complete example of the `upsertDeployment` mutation, see [Upsert a Deployment with the APC API](/docs/astro-private-cloud/v-2-x/houston-upsert-deployment).