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

# Account

> Accedi, disconnettiti e ispeziona il contesto dell’account CLI attivo

La CLI usa una chiave API per i comandi autenticati. Puoi salvarla una volta con `youka login`, oppure fornirla tramite `YOUKA_API_KEY` in CI e in altri ambienti non interattivi.

`youka login` verifica la chiave tramite l’API prima di salvarla, poi memorizza nella cache l’email dell’account risolta in `~/.youka/config.json` per la diagnostica.

## `login`

Salva una chiave API in `~/.youka/config.json`.

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

<ParamField path="token" type="string">
  La chiave API copiata dalla dashboard Youka. Se omessa, la CLI la richiede
  in un terminale interattivo.
</ParamField>

### Esempi

<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>In CI, preferisci `YOUKA_API_KEY` invece di scrivere un file di configurazione.</Tip>

## `logout`

Rimuovi la chiave API salvata da `~/.youka/config.json`.

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

## `whoami`

Ispeziona l’origine risolta della chiave, l’URL dell’API e l’identità dell’account.

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

Risposta di esempio:

```json theme={null}
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/it/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"
  }
}
```

### Ordine di risoluzione

| Campo   | Ordine                                                                     |
| ------- | -------------------------------------------------------------------------- |
| API key | `YOUKA_API_KEY`, poi `~/.youka/config.json`                                |
| API URL | `--api`, poi `YOUKA_API_BASE_URL`, poi `~/.youka/config.json`, poi default |

Quando è attiva una chiave di configurazione salvata, `whoami` verifica l’identità con l’API e ripiega sull’email dell’account in cache solo se la ricerca live non è disponibile. Non usa l’identità in cache della configurazione per i token `YOUKA_API_KEY`.

## Cosa fare dopo

* [Opzioni globali](/it/cli/global-options) - flag condivise da ogni comando
* [Progetti](/it/cli/projects) - crea ed elabora progetti karaoke