# Gerenciando chaves de API

As chaves de API permitem que ferramentas externas e automações interajam com seu workspace de forma programática. Os administradores do workspace podem criar, ver e revogar chaves a qualquer momento.

### Criando uma chave de API

Vá para **Configurações → API → Chaves** e clique em **Nova chave de API**. Dê à chave um nome descritivo (por exemplo, "integração CI/CD" ou "dashboard interno") para você poder identificá-la depois.

{% hint style="warning" %}
Copie sua chave logo depois de criá-la — ela não será mostrada de novo. Se você a perder, vai precisar revogar e criar outra.
{% endhint %}

### Permissões da chave

Ao criar uma chave, você pode definir o escopo das permissões dela:

| Permissão         | O que ela permite                                 |
| ----------------- | ------------------------------------------------- |
| **Leitura**       | Buscar conteúdo, configurações e dados de membros |
| **Escrita**       | Criar e atualizar conteúdo                        |
| **Administrador** | Gerenciar configurações, membros e faturamento    |

Use o mínimo de permissões necessário para cada integração.

### Rotacionando uma chave

Para rotacionar uma chave, crie uma nova, atualize sua integração para usá-la e depois revogue a chave antiga. Não há rotação automatizada — este é um processo manual.

### Revogando uma chave

Vá para **Configurações → API → Chaves**, encontre a chave e clique em **Revogar**. A revogação é imediata — qualquer solicitação que use essa chave vai falhar na hora.

### Monitorando o uso

Em **Configurações → API → Uso**, você pode ver a contagem de solicitações por chave nos últimos 30 dias. Isso é útil para identificar uso inesperado ou ver quais integrações estão mais ativas.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://isbm.savimbo.com/practice-guide/pt-br/administrador/gerenciando-chaves-de-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.