> ## 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.

# Clés d'API

> Créez, listez et révoquez des clés d'API pour un accès programmatique depuis la CLI

Les clés d'API authentifient la CLI, l'API REST publique, le serveur MCP, le nœud n8n et les webhooks. Ces commandes vous permettent de gérer les clés de votre espace de travail actuel.

## settings:api-keys

Liste toutes les clés d'API de votre espace de travail. Seules les métadonnées sont renvoyées (id, nom, préfixe de la clé, date de création) — le secret complet n'est jamais affiché après la création.

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

```bash Exemples 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

Crée une nouvelle clé d'API. La clé complète est affichée une seule fois en cas de succès, puis seules les métadonnées (`id`, `name`, `keyPrefix`, `createdAt`) sont montrées — elle n'est pas stockée et ne peut plus être récupérée.

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

| Option | Description |
| - | - |
| `--name <name>` | Nom de la clé **(obligatoire)** |

```bash Exemples 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 Sortie 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 clé d'API complète n'est affichée qu'une seule fois, immédiatement après sa création. Copiez-la dans un endroit sûr (un gestionnaire de secrets ou une variable d'environnement). Si vous la perdez, révoquez la clé et créez-en une nouvelle.

## settings:revoke-api-key

Révoque une clé d'API à partir de son ID. Par défaut, une confirmation est demandée ; passez `-y`/`--yes` pour l'ignorer. Une fois révoquée, tout client utilisant cette clé sera rejeté.

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

| Argument / Option | Description |
| - | - |
| `<id>` | ID de la clé d'API **(obligatoire)** |
| `-y, --yes` | Ignore la demande de confirmation |

```bash Exemples 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.