> ## 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.

# astro deployment pool create

<Info>
  This command is only available on Astro.
</Info>

Create Airflow pools in a Deployment. Airflow pools are stored in the Deployment's metadata database and appear in the Airflow UI.

## Usage

```sh wrap theme={null}
astro deployment pool create
```

<Tip>
  This command is recommended for automated workflows. To run this command in an automated process such as a [CI/CD pipeline](/docs/astro/set-up-ci-cd), you can generate an API token, then specify the `ASTRO_API_TOKEN` environment variable in the system running the Astro CLI:

  ```bash wrap theme={null}
  export ASTRO_API_TOKEN=<your-token>
  ```

  See [Organization](/docs/astro/organization-api-tokens), [Workspace](/docs/astro/workspace-api-tokens), and [Deployment](/docs/astro/deployment-api-tokens) API token documentation for more details about ways to use API tokens.
</Tip>

## Options

| Option                 | Description                                                                                                                      | Possible Values           |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| `-d`,`--deployment-id` | The ID of the Deployment where you want to create Airflow pools.                                                                 | Any valid Deployment ID   |
| `--deployment-name`    | The name of the Deployment where you want to create Airflow pools. Use as an alternative to `<deployment-id>`.                   | Any valid Deployment name |
| `-w`,`--workspace-id`  | Create Airflow pools in a Deployment that is not in your current Workspace. If not specified, your current Workspace is assumed. | Any valid Workspace ID    |
| `--name`               | The Airflow pool name. Required.                                                                                                 | Any string                |
| `-v`,`--slots`         | Number of airflow pool slots. Required.                                                                                          | Any integer               |
| `--description`        | The pool description.                                                                                                            | Any string                |

## Examples

```bash wrap theme={null}
# create pool called my-pool stored in the Deployment with an ID of cl03oiq7d80402nwn7fsl3dmv
astro deployment pool create --deployment-id cl03oiq7d80402nwn7fsl3dmv --name my-pool --slots 10

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

## Related commands

* [`astro deployment pool copy`](/docs/cli/v1.39/astro-deployment-pool-copy)
* [`astro deployment pool update`](/docs/cli/v1.39/astro-deployment-pool-update)