---
description: >-
  Manage secure secrets registered with Roboto. These are typically 3rd party
  API keys to power integrations.
sidebar:
  order: 10
title: roboto secrets
---
```bash
roboto secrets [-h] {delete,list,write} ...
```

**Arguments**

| Argument | Description |
| --- | --- |
| `-h, --help` | show this help message and exit |

## roboto secrets delete

Deletes a secret from the Roboto platform. This operation cannot be undone.

```bash
roboto secrets delete [-h] [--org ORG] secret_name
```

**Arguments**

| Argument | Description |
| --- | --- |
| `secret_name` Required | The name of the secret to delete. |
| `-h, --help` | show this help message and exit |
| `--org <org>` | The calling organization ID. Gets set implicitly if in a single org. The `ROBOTO_ORG_ID` environment variable can be set to control the default value; without it, the default is the `org_id` of the config file profile in use, which `roboto setup` saves. |

## roboto secrets list

List all secrets in an organization. This does not reveal the secret values, only the secret names and metadata.

```bash
roboto secrets list [-h] [--org ORG]
```

**Arguments**

| Argument | Description |
| --- | --- |
| `-h, --help` | show this help message and exit |
| `--org <org>` | The calling organization ID. Gets set implicitly if in a single org. The `ROBOTO_ORG_ID` environment variable can be set to control the default value; without it, the default is the `org_id` of the config file profile in use, which `roboto setup` saves. |

## roboto secrets write

Write a new value to a new or existing secret.

```bash
roboto secrets write [-h] [--org ORG] secret_name secret_value
```

**Arguments**

| Argument | Description |
| --- | --- |
| `secret_name` Required | The name of the secret to write. |
| `secret_value` Required | The value to write to the secret. |
| `-h, --help` | show this help message and exit |
| `--org <org>` | The calling organization ID. Gets set implicitly if in a single org. The `ROBOTO_ORG_ID` environment variable can be set to control the default value; without it, the default is the `org_id` of the config file profile in use, which `roboto setup` saves. |