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

# Autenticação

> Autenticação por API Key para a Grwthy API

# Autenticação

Todas as requisições à API requerem o header `X-Api-Key`.

## API Key

A API Key é criada no [Dashboard do Grwthy](https://grwthy.com), na página **API Keys**. Cada key pertence a um **usuário** e está vinculada a um **Business Account**, dando acesso às instâncias daquele account.

```bash theme={null}
X-Api-Key: SUA_API_KEY
```

### Criando API Keys

Ao criar uma key no Dashboard, você pode:

* Dar um nome descritivo (ex: "Produção", "Staging", "Testes")
* Definir uma data de expiração ou escolher "Nunca expira"

<Warning>A API key completa é exibida apenas uma vez no momento da criação. Armazene-a com segurança.</Warning>

### Expiração

Keys com data de expiração são automaticamente invalidadas após a data configurada. Requisições com keys expiradas retornam:

```json theme={null}
{
  "statusCode": 401,
  "message": "API key expired"
}
```

### Revogação

Keys podem ser revogadas a qualquer momento no Dashboard. Uma key revogada é imediatamente invalidada e não pode ser reativada.

## Respostas de Erro

| Status | Descrição                             |
| ------ | ------------------------------------- |
| `401`  | API key ausente, inválida ou expirada |

```json theme={null}
{
  "statusCode": 401,
  "message": "Missing X-Api-Key header"
}
```

## Boas Práticas

* Armazene API keys em variáveis de ambiente, nunca no código-fonte
* Crie keys separadas para ambientes diferentes (produção, staging, desenvolvimento)
* Configure expiração para keys temporárias
* Revogue keys que não são mais necessárias