> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Claves de API

> Crea, lista y revoca claves de API para el acceso programático desde la CLI

Las claves de API autentican la CLI, la API REST pública, el servidor MCP, el nodo de n8n y los webhooks. Estos comandos te permiten gestionar las claves de tu espacio de trabajo actual.

## settings:api-keys

Lista todas las claves de API de tu espacio de trabajo. Solo se devuelven metadatos (id, nombre, prefijo de la clave, fecha de creación); el secreto completo nunca se muestra después de la creación.

```bash theme={null}
so-me settings:api-keys
```

```bash Ejemplos theme={null}
# All keys as JSON
so-me settings:api-keys

# Compact table
so-me settings:api-keys --table

# Map each key name to its ID
so-me settings:api-keys | jq -r '.[] | "\(.id)\t\(.name)"'
```

## settings:create-api-key

Crea una nueva clave de API. La clave completa se imprime una sola vez al crearla y después solo se muestran metadatos (`id`, `name`, `keyPrefix`, `createdAt`); no se almacena y no se puede recuperar de nuevo.

```bash theme={null}
so-me settings:create-api-key --name <name>
```

| Opción | Descripción |
| - | - |
| `--name <name>` | Nombre de la clave **(obligatorio)** |

```bash Ejemplos theme={null}
# Create a key for CI
so-me settings:create-api-key --name "ci-pipeline"

# Create a key for a teammate's local machine
so-me settings:create-api-key --name "jane-laptop"
```

```text Salida theme={null}
  API key created

  Save this key — it will not be shown again:

  sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

  { "id": "...", "name": "ci-pipeline", "keyPrefix": "sk_live_xxxx", "createdAt": "..." }
```

> [!WARNING]
>
> La clave de API completa se muestra una sola vez, justo después de crearla. Cópiala en un lugar seguro (un gestor de secretos o una variable de entorno). Si la pierdes, revoca la clave y crea una nueva.

## settings:revoke-api-key

Revoca una clave de API por su ID. Por defecto se muestra una confirmación; pasa `-y`/`--yes` para omitirla. Una vez revocada, se rechazará a cualquier cliente que use esa clave.

```bash theme={null}
so-me settings:revoke-api-key <id> [options]
```

| Argumento / Opción | Descripción |
| - | - |
| `<id>` | ID de la clave de API **(obligatorio)** |
| `-y, --yes` | Omite la confirmación |

```bash Ejemplos theme={null}
# Interactive (prompts for confirmation)
so-me settings:revoke-api-key 550e8400-e29b-41d4-a716-446655440000

# Non-interactive (for scripts)
so-me settings:revoke-api-key 550e8400-e29b-41d4-a716-446655440000 --yes

# Find a key by name, then revoke it
ID=$(so-me settings:api-keys | jq -r '.[] | select(.name=="ci-pipeline") | .id')
so-me settings:revoke-api-key "$ID" --yes
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.