> ## 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 service-account

<Info>This command is available only if you're authenticated to an Astro Private Cloud installation.</Info>

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`

```sh wrap theme={null}
# Creates a Deployment-level service account
astro deployment service-account create --deployment-id=<your-deployment-id> --label=<your-service-account-label>

# Deletes a Deployment-level service account
astro 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`. |