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

# Conta

> Faça login, logout e inspecione o contexto ativo da conta no CLI

O CLI usa uma chave de API para comandos autenticados. Você pode salvá-la uma vez com `youka login` ou fornecê-la via `YOUKA_API_KEY` em CI e outros ambientes não interativos.

`youka login` verifica a chave na API antes de salvá-la e, em seguida, armazena em cache o e-mail da conta resolvida em `~/.youka/config.json` para diagnóstico.

## `login`

Salve uma chave de API em `~/.youka/config.json`.

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

<ParamField path="token" type="string">
  A chave de API copiada do painel do Youka. Se omitida, o CLI solicita
  em um terminal interativo.
</ParamField>

### Exemplos

<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>Em CI, prefira `YOUKA_API_KEY` em vez de gravar um arquivo de configuração.</Tip>

## `logout`

Remova a chave de API salva de `~/.youka/config.json`.

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

## `whoami`

Inspecione a origem da chave resolvida, a URL da API e a identidade da conta.

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

Resposta de exemplo:

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

### Ordem de resolução

| Campo        | Ordem                                                                              |
| ------------ | ---------------------------------------------------------------------------------- |
| Chave de API | `YOUKA_API_KEY`, depois `~/.youka/config.json`                                     |
| URL da API   | `--api`, depois `YOUKA_API_BASE_URL`, depois `~/.youka/config.json`, depois padrão |

Quando uma chave de configuração salva está ativa, `whoami` verifica a identidade na API e recorre ao e-mail da conta em cache somente se a consulta ao vivo não estiver disponível. Ele não usa a identidade em cache da configuração para tokens `YOUKA_API_KEY`.

## Próximos passos

* [Opções globais](/pt/cli/global-options) - flags compartilhadas por todos os comandos
* [Projetos](/pt/cli/projects) - crie e processe projetos de karaokê