---
title: "tractorbeam secret"
description: "Manage encrypted Secret values."
sidebar:
  label: "secret"
  order: 12
---

```sh
tractorbeam secret <subcommand> [flags]
```

## Shared flags

Every subcommand takes these flags.

| Flag | Description |
| --- | --- |
| `--config <string>` | The Project's `tractorbeam.config.ts`. Defaults to the one in the current directory or its nearest ancestor. |
| `--workspace <string>` | Workspace identifier or resource name. Environment variable: `TRACTORBEAM_WORKSPACE`. |
| `--origin <string>` | The Tractorbeam origin to call instead of the default, such as a proxy's. Environment variable: `TRACTORBEAM_ORIGIN`. |
| `--token <string>` | Access token. Defaults to the saved interactive session. Environment variable: `TRACTORBEAM_TOKEN`. |

## `secret set`

Set a Secret's value for every Branch. The value has to match the Secret's schema on the Branch.

```sh
tractorbeam secret set [flags] <secret>
```

| Argument | Description |
| --- | --- |
| `<secret>` | Secret identifier or resource name. |

| Flag | Description |
| --- | --- |
| `--file <string>` | Read the JSON value from this file instead of standard input. |
| `--branch <string>` | Branch identifier or resource name. Defaults to the Branch you last switched to, or main. Environment variable: `TRACTORBEAM_BRANCH`. |

Examples:

```sh
# Set the stripe Secret from a JSON file
tractorbeam secret set stripe --file stripe.json

# Set it from standard input
tractorbeam secret set stripe < stripe.json
```

## `secret delete`

Delete a Secret's value on every Branch.

```sh
tractorbeam secret delete [flags] <secret>
```

| Argument | Description |
| --- | --- |
| `<secret>` | Secret identifier or resource name. |
