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

# Compte

> Connectez-vous, déconnectez-vous et inspectez le contexte de compte CLI actif

La CLI utilise une clé API pour les commandes authentifiées. Vous pouvez l’enregistrer une seule fois avec `youka login`, ou la fournir via `YOUKA_API_KEY` en CI et dans d’autres environnements non interactifs.

`youka login` vérifie la clé auprès de l’API avant de l’enregistrer, puis met en cache l’e-mail du compte résolu dans `~/.youka/config.json` à des fins de diagnostic.

## `login`

Enregistrer une clé API dans `~/.youka/config.json`.

```bash theme={null}
youka login [token]
```

<ParamField path="token" type="string">
  La clé API copiée depuis le tableau de bord Youka. Si elle est omise, la CLI la demande
  sur un terminal interactif.
</ParamField>

### Exemples

<CodeGroup>
  ```bash token theme={null}
  youka login yk_live_abcd1234
  ```

  ```bash with-api theme={null}
  youka login yk_live_abcd1234 --api https://staging-api.youka.test --json
  ```
</CodeGroup>

<Tip>En CI, privilégiez `YOUKA_API_KEY` plutôt que d’écrire un fichier de configuration.</Tip>

## `logout`

Supprimer la clé API enregistrée de `~/.youka/config.json`.

```bash theme={null}
youka logout
youka logout --json
```

## `whoami`

Inspecter la source de clé résolue, l’URL de l’API et l’identité du compte.

```bash theme={null}
youka whoami
youka whoami --json
```

Exemple de réponse :

```json theme={null}
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/fr/api/v1",
    "apiUrlSource": "default",
    "email": "user@example.com",
    "userId": "user_123",
    "apiKeyId": "key_123",
    "org": null,
    "configPath": "/Users/you/.youka/config.json",
    "apiKeyPreview": "yk_l...1234"
  }
}
```

### Ordre de résolution

| Champ   | Ordre                                                                        |
| ------- | ---------------------------------------------------------------------------- |
| Clé API | `YOUKA_API_KEY`, puis `~/.youka/config.json`                                 |
| URL API | `--api`, puis `YOUKA_API_BASE_URL`, puis `~/.youka/config.json`, puis défaut |

Lorsqu’une clé de configuration enregistrée est active, `whoami` vérifie l’identité auprès de l’API et ne revient à l’e-mail du compte mis en cache que si la recherche en direct est indisponible. Il n’utilise pas l’identité mise en cache dans la configuration pour les jetons `YOUKA_API_KEY`.

## Et ensuite

* [Options globales](/fr/cli/global-options) - options partagées par chaque commande
* [Projets](/fr/cli/projects) - créer et traiter des projets de karaoké