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

# Admin API

> Use a Replit Enterprise Admin API para acessar o uso da conta, workspaces, membros e projetos de forma programática.

<Note>
  A Admin API está em **beta**. Os endpoints disponíveis e o comportamento podem mudar.
</Note>

A Admin API oferece aos administradores de conta Enterprise acesso somente leitura e programático a dados de análise e administração da conta. Use-a para criar relatórios internos, fluxos de trabalho operacionais e integrações para sua conta Enterprise.

## Quem pode acessar a Admin API

A Admin API está disponível apenas para **administradores de conta** em contas Enterprise. Administradores de conta podem criar e gerenciar chaves de API. Administradores de workspace e outros membros da conta não podem acessar a Admin API nem criar suas chaves.

Para saber mais sobre as funções de administrador Enterprise, veja [Administradores de Conta e de Workspace](/pt/teams/identity-and-access-management/account-and-workspace-admins).

## Criar uma chave de API

<Steps>
  <Step title="Abrir as configurações de Desenvolvedor">
    Na sua conta Enterprise, abra **Settings** e selecione **Developer**.
  </Step>

  <Step title="Criar uma chave de API">
    Selecione **Create API key**. As chaves da Admin API são somente leitura.
  </Step>

  <Step title="Armazene sua chave com segurança">
    Copie a chave, que começa com `rpl_`, e armazene-a em um gerenciador de segredos seguro. Trate-a como uma senha e nunca a compartilhe.
  </Step>

  <Step title="Autentique sua integração">
    Envie a chave como um Bearer token nas suas requisições de API.
  </Step>
</Steps>

## O que você pode fazer

A Admin API oferece endpoints somente leitura para:

* **Uso:** Uso da conta e custo bruto no livro-razão, filtrado ou agrupado por workspace, membro, projeto ou período.
* **Workspaces:** Listas e detalhes de workspaces, incluindo contagem de membros e projetos, administradores e data de criação.
* **Membros:** Associação à conta e a workspaces, filtrada por função ou pesquisada por nome, nome de usuário ou e-mail.
* **Projetos:** Projetos em workspaces de equipe, filtrados por visibilidade ou status de implantação, ou pesquisados por título, slug ou descrição.

As respostas da API oferecem suporte a paginação por cursor e incluem cabeçalhos de limite de taxa e um `X-Request-Id` para rastreamento de requisições.

## Construindo com o Replit Agent

Você pode pedir ao Replit Agent para construir um painel personalizado com a Admin API. Descreva os dados da conta que deseja acompanhar, como uso por workspace ou custos por projeto, e o Agent pode construir o painel e sua integração de API.

<Steps>
  <Step title="Abra o seletor de skills">
    Em um projeto Replit, clique no botão **+** ao lado da entrada de chat e selecione **Use a skill**.
  </Step>

  <Step title="Selecione a skill Admin API">
    Em **Replit skills**, selecione **Admin API** para dar ao Agent o contexto da API e orientações de integração.
  </Step>

  <Step title="Descreva o painel">
    Diga ao Agent o que você quer acompanhar e como quer visualizá-lo. Por exemplo, peça ao Agent para construir um painel que mostre uso por workspace e custo por projeto.
  </Step>

  <Step title="Adicione sua chave de API com segurança">
    Quando o Agent precisar fazer requisições de API, adicione sua chave da Admin API aos Secrets do seu projeto. Não cole a chave no chat nem a inclua em commits do seu projeto.
  </Step>
</Steps>

## Referência da API

Para detalhes de endpoints, parâmetros de requisição e exemplos de integração, veja a [documentação para desenvolvedores da Admin API](https://api.replit.com/docs).