# Como acessar a Zild API

Gere uma API Key de usuário, entenda o escopo de permissões e conecte ferramentas como Claude Code e Codex diretamente à API da Zild.

Source: https://zild.ai/pt-BR/docs/api-reference/how-to-access-zild-api

## Gere sua API Key

- Entre na Zild e abra o seu [Perfil](https://app.zild.ai/pt-BR/my-profile).
- Localize a seção API Key e escolha a opção para gerar uma chave.
- Copie o valor gerado e armazene-o em um gerenciador de segredos seguro. Não inclua a chave em código-fonte, repositórios, logs, capturas de tela ou documentos compartilhados.

![](/images/docs/step-by-step-pt-br.png)

## Autentique as requisições

Envie a chave no header `X-API-Key` em todas as requisições à API da Zild:



```
X-API-Key: YOUR_USER_API_KEY
```


Exemplo:



```
curl --request GET \
  --url 'https://api.zild.ai/Agent' \
  --header 'X-API-Key: YOUR_USER_API_KEY'
```



## A chave usa as suas permissões

Uma API Key gerada possui os mesmos acessos do usuário que a gerou. Ela pode consultar ou alterar somente os recursos que esse usuário tem permissão para acessar na Zild. Se os papéis, grupos, acesso ao tenant ou permissões do usuário mudarem, o acesso efetivo pela API também muda.

Trate a chave como uma credencial do usuário. Gere-a para a pessoa ou serviço com o escopo de permissões adequado, aplique o princípio do menor privilégio e substitua-a imediatamente caso possa ter sido exposta.

## Use com agentes de programação

Você pode fornecer a API Key com segurança a ferramentas desktop como Claude Code e Codex para que um agente use a API da Zild diretamente. Armazene-a na configuração de segredos ou de ambiente da ferramenta e instrua o agente a enviar `X-API-Key: YOUR_USER_API_KEY` nas requisições para `https://api.zild.ai`.

O agente não recebe privilégios adicionais na Zild: toda ação pela API continua limitada aos acessos do usuário que gerou a chave. Revise as permissões e a operação solicitada antes de permitir que um agente use a credencial.