As chaves de API internas são credenciais internas, geradas e administradas por sua conta VTEX. Isso significa que você deve ter acesso a todos os pares de chaves e tokens de API — o equivalente a nomes de usuário e senhas para integrações de API.

A aba Geradas apresenta a listagem de chaves de API criadas pela sua conta. Você pode utilizar a barra de busca para encontrar uma chave pelo nome ou valor preenchido em Identificação da chave ao gerá-la.

A página apresenta as informações a seguir em uma tabela:

Coluna	Descrição
Chave/Nome	Chave de API, seguida pelo nome definido durante a criação da chave. Se o token tiver passado do período de renovação recomendado (3 meses, por padrão), ao lado da chave aparece um ícone de alerta para renovação. Saiba mais em Configurar alerta para renovar tokens de API.
Perfil de acesso	Perfis de acesso associados à chave de API.
Data de criação	Data de criação da chave de API.
Status	Status da chave de API, que pode ser Ativo ou Inativo.

Esta página permite que você realize as seguintes ações:

• Gerar chave
• Editar chave gerada
• Inativar ou ativar chave gerada
• Renovar token
• Excluir chave

Siga as instruções abaixo para criar uma nova chave de API:

1. Na barra superior do Admin VTEX, clique no avatar do seu perfil, marcado pela inicial do seu email, e depois em Configurações da conta > Chaves de API.

2. Certifique-se de que você está na aba Geradas.

3. Clique em + Gerar chave.

4. Preencha o campo Identificação da chave com o nome para identificar a chave de API. Este campo é obrigatório.

5. Selecione os perfis de acesso que serão associados à chave. Por padrão, nenhum perfil de acesso é pré-selecionado.

   Marque apenas os perfis de acesso necessários para a integração que utilizará a chave de API. O uso irrestrito de perfis de acesso muito permissivos aumenta o risco de ataques nas lojas por vazamento de credenciais de login.

6. Clique em Gerar.

   Você poderá visualizar o token a partir de um link de acesso único, com duração de 24 horas se não houver acesso.

7. Clique em Copiar para copiar o link de acesso único ao novo token para a área de transferência. Este link será exibido apenas uma vez. Nesta etapa, a chave já está ativa e disponível para uso.

8. Clique em Encerrar.

9. Acesse o link copiado ou compartilhe-o com a pessoa que vai utilizar o token. O link pode ser acessado apenas uma vez e tem duração de 24 horas se não houver acesso.

10. Clique em Copiar para copiar o token da API para a área de transferência. Esse segredo será exibido apenas uma vez. Salve-o em um local seguro.

A URL oficial para acessar o token segue sempre o formato share.vtex.com/credentials/{token}. O {token} é um identificador aleatório gerado no momento da criação ou renovação da chave. Verifique o formato do link antes de acessá-lo para evitar riscos de phishing ou acesso a páginas maliciosas.

Siga o passo a passo abaixo para realizar alterações em uma chave de API:

1. Na barra superior do Admin VTEX, clique no avatar do seu perfil, marcado pela inicial do seu email, e depois em Configurações da conta > Chaves de API.
2. Certifique-se de que você está na aba Geradas.
3. Na linha de uma chave de API, clique no menu ⋮ e depois em Editar.
4. Aplique as modificações desejadas, entre as opções abaixo:
   • Modificar a seleção de perfis de acesso associados à chave de API.
   • Desmarcar ou marcar a opção Ativa para inativar ou ativar a chave gerada.
5. Clique em Salvar.

Se uma chave de API que tenha acesso à sua conta for comprometida, você deve inativá-la imediatamente para revogar o acesso à sua conta. Se necessário, você pode gerar uma nova chave para substituir a anterior.

Caso cometa algum erro, é possível reativar a chave de API para restabelecer a integração impactada.

Siga o passo a passo abaixo para inativar ou ativar uma chave de API:

1. Na barra superior do Admin VTEX, clique no avatar do seu perfil, marcado pela inicial do seu email, e depois em Configurações da conta > Chaves de API.
2. Certifique-se de que você está na aba Geradas.
3. Na linha de uma chave de API, clique no menu ⋮ e prossiga para uma das ações a seguir:
   • Inativar: se a chave estiver ativa, clique em Inativar para desabilitá-la. Essa ação vai interromper integrações que utilizem a chave, então utilize-a com cautela. É necessário clicar em Inativar mais uma vez para confirmar a ação.
   • Ativar: se a chave estiver inativa, clique em Ativar para disponibilizá-la para uso.

Renovar o token de API com frequência é crucial para manter a segurança da sua loja. Para garantir a proteção contínua, faça a renovação antes mesmo de receber o alerta para isso. Siga as instruções descritas em Renovar token de API.

Chaves de API que não serão mais utilizadas podem ser excluídas. Ao excluir essas chaves, é possível manter a listagem organizada e facilitar o gerenciamento das chaves em uso.

Certifique-se de que a chave de API não está mais em uso por nenhuma integração antes de excluí-la. Este procedimento não pode ser desfeito.

Para excluir uma chave de API de forma definitiva, siga os passos abaixo:

1. Na barra superior do Admin VTEX, clique no avatar do seu perfil, marcado pela inicial do seu email, e depois em Configurações da conta > Chaves de API.
2. Certifique-se de que você está na aba Geradas.
3. Na linha de uma chave de API, clique no menu ⋮ e depois em Excluir chave.
4. Marque a opção Entendo que essa ação não pode ser desfeita.
5. Para confirmar, clique em Excluir.

• Chaves de API
• Renovar token de API
• Configurar alerta para renovar tokens de API
• Chaves externas