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

# Autenticação

> Como autenticar e gerar chaves de API para acessar os endpoints

## Visão geral

A API utiliza autenticação por chave de API via cabeçalho `X-API-Key`. As chaves possuem escopos que controlam permissões de leitura e escrita.

## Como gerar uma chave de API

1. Navegue até o seu workspace
2. Clique no icone do usuário > Configurações > Chaves API
3. Na seção "Chaves API", clique em "+ Nova chave API"
4. Dê um nome para ele e clique em "Criar"
5. Copie seu token

<Frame>
  <img src="https://mintcdn.com/aivra-fa464470/6F_yrFrW4EF-jmWC/images/api/authentication/generateToken.png?fit=max&auto=format&n=6F_yrFrW4EF-jmWC&q=85&s=d83bbe868129ec4698eced6cd1934315" width="900" alt="Generate token" data-path="images/api/authentication/generateToken.png" />
</Frame>

## Como enviar a chave nas requisições

Adicione o cabeçalho:

`X-API-Key: ak_xxxxxxxxxxxxxxxxx`

Exemplo:

```bash theme={null}
curl -H "X-API-Key: ak_xxxxxxxxx" "${BASE_URL}/v1/integration/projects"
```

## Erros comuns de autenticação

* `401 API_KEY_REQUIRED`: cabeçalho ausente ou formato inválido
* `401 API_KEY_INVALID`: chave inexistente ou revogada
* `403 FORBIDDEN`: escopo insuficiente para a operação