> ## 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 connection update

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

Update the value for a Deployment's Airflow variable.

## Usage

```sh wrap theme={null}
astro deployment connection update
```

<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 a connection.                                                                  | Any valid Deployment ID   |
| `--deployment-name`    | The name of the Deployment where you want to create a connection. Use as an alternative to `<deployment-id>`.                    | Any valid Deployment name |
| `-w`,`--workspace-id`  | Create a connection for a Deployment that is not in your current Workspace. If not specified, your current Workspace is assumed. | Any valid Workspace ID    |
| `-i`,`--conn-id`       | The connection ID. Required.                                                                                                     | string                    |
| `-t`,`--conn-type`     | The connection type. Required.                                                                                                   | string                    |
| `--description`        | The connection description.                                                                                                      | string                    |
| `--extra`              | The extra field configuration, defined as a stringified JSON object.                                                             | string                    |
| `--host`               | The connection host.                                                                                                             | string                    |
| `--login`              | The connection login or username.                                                                                                | string                    |
| `--password`           | The connection password.                                                                                                         | string                    |
| `--port`               | The connection port.                                                                                                             | string                    |
| `--schema`             | The connection schema.                                                                                                           | string                    |

## Examples

```bash wrap theme={null}
# update connection called my-connection stored in the Deployment with an ID of cl03oiq7d80402nwn7fsl3dmv
astro deployment connection update --deployment-id cl03oiq7d80402nwn7fsl3dmv --conn-id my-connection --conn-type http

# update connections stored in the Deployment "My Deployment"
astro deployment connection update --deployment-name="My Deployment" --conn-id my-connection --conn-type http
```

## Related commands

* [`astro deployment connection create`](/docs/cli/v1.39/astro-deployment-connection-create)
* [`astro deployment connection list`](/docs/cli/v1.39/astro-deployment-connection-list)