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

# Tokens de acesso pessoal

> Autentique-se com sua própria conta para acesso programático à API

<div id="overview">
  ## Visão geral
</div>

Tokens de Acesso Pessoal (PATs) permitem que usuários humanos se autentiquem programaticamente com sua própria identidade. Ao contrário das chaves de API de usuário de serviço (que autenticam como um usuário de serviço não humano), um PAT autentica como **você** — o usuário humano que criou o token.

| Tipo de token                          | Autentica como                  | Identidade                         | Permissões                               |
| -------------------------------------- | ------------------------------- | ---------------------------------- | ---------------------------------------- |
| **Chave de API de Usuário de Serviço** | Usuário de Serviço (não humano) | A identidade do usuário de serviço | A função atribuída ao usuário de serviço |
| **Token de Acesso Pessoal**            | Usuário (humano)                | Sua identidade de usuário          | Suas permissões e associações à org      |

Todas as credenciais de API usam o formato de prefixo `cog_`. Ambos os tipos de token são usados da mesma forma no cabeçalho `Authorization`:

```bash theme={null}
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $YOUR_PAT"
```

<div id="when-to-use-pats">
  ## Quando usar PATs
</div>

PATs foram criados para cenários em que você precisa de acesso programático à API **em seu próprio nome**:

* **Scripts e ferramentas pessoais** — automatize seus próprios workflows sem um usuário de serviço compartilhado
* **Desenvolvimento local** — teste integrações de API usando sua própria conta
* **Automação de curta duração** — scripts pontuais que devem ser atribuídos a você

Para integrações em produção, pipelines de CI/CD e automações compartilhadas, use [Chaves de API de usuários de serviço](/pt-BR/api-reference/authentication#service-users-recommended-for-automation). Usuários de serviço oferecem melhores trilhas de auditoria, gerenciamento centralizado de chaves e controles de RBAC.

<div id="creating-and-managing-pats">
  ## Como criar e gerenciar PATs
</div>

Gerencie seus PATs na aba **PATs** da página de **Configurações da API do Devin**.

1. **Crie um PAT** — dê a ele um nome e uma data de expiração. O token começa com `cog_` e é exibido apenas uma vez, no momento da criação.
2. **Use o token** no cabeçalho `Authorization` — exatamente como uma chave de API de usuário de serviço. Cada chamada à API é autenticada usando sua conta de usuário: suas permissões, associações a orgs e trilha de auditoria se aplicam.
3. **Faça a rotação de um PAT** — gere um novo segredo para um token existente sem alterar seu nome; o segredo antigo deixa de funcionar imediatamente.
4. **Revogue um PAT** — invalide o token a qualquer momento.

PATs também são aceitos por endpoints em tempo real, como o WebSocket ao vivo do ACP, permitindo que ferramentas como o Devin CLI e clientes de desktop se autentiquem com um PAT.

<div id="enterprise-governance">
  ## Governança do Enterprise
</div>

Para contas Enterprise, a disponibilidade de PATs é controlada por uma **política de PATs** válida para todas as organizações do Enterprise. Os admins do Enterprise configuram a política na aba **Políticas de PAT** da página de configurações da **API do Devin** do Enterprise.

<div id="policy-modes">
  ### Modos de política
</div>

| Modo                     | Comportamento                                                                                                              |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| **Desativado** (padrão)  | Os membros não podem criar nem usar PATs                                                                                   |
| **Aprovação necessária** | Os membros enviam uma solicitação de PAT; um administrador Enterprise precisa aprová-la antes que o token possa ser criado |
| **Autoatendimento**      | Os membros podem criar PATs diretamente, sujeitos à política de expiração                                                  |

<div id="expiration-policy">
  ### Política de expiração
</div>

Quando os PATs estão ativados em uma Enterprise, todo PAT **deve ter uma data de expiração**, limitada pela duração máxima definida na política (**365 dias** por padrão; os administradores podem configurar um limite menor). Contas não Enterprise (Teams) podem criar PATs sem data de expiração.

<div id="approval-workflow">
  ### Fluxo de aprovação
</div>

Em **Aprovação necessária**:

1. Um membro solicita um PAT na aba PATs (nome + data de expiração).
2. Os admins do Enterprise veem a solicitação na **Fila de aprovação** e a aprovam ou negam.
3. Após a aprovação, o membro conclui a solicitação para gerar o token (exibido apenas uma vez).
4. As solicitações pendentes expiram automaticamente após **7 dias** se nenhuma ação for tomada.

Solicitantes e admins são notificados por e-mail em cada etapa do ciclo de vida do token (solicitado, aprovado, negado, revogado).

<div id="token-inventory-and-revocation">
  ### Inventário e revogação de tokens
</div>

Os admins do Enterprise podem:

* **Visualizar todos os PATs** da empresa no inventário de tokens, incluindo o status de conformidade com a política atual
* **Revogar tokens em massa** (por exemplo, após tornar a política mais restritiva)

Tornar a política mais restritiva (ou desabilitar PATs) cancela as requisições pendentes afetadas, e o inventário sinaliza os tokens existentes que não estão mais em conformidade.

<div id="automatic-revocation">
  ### Revogação automática
</div>

Os PATs de um usuário são revogados automaticamente quando ele deixa de fazer parte da conta, inclusive em remoções por desprovisionamento via SCIM ou alterações no grupo do IdP.

<div id="security-considerations">
  ## Considerações de segurança
</div>

* Trate os PATs com o mesmo cuidado que senhas — eles dão acesso total à sua conta
* Armazene os PATs em variáveis de ambiente ou gerenciadores de segredos, nunca no código-fonte
* Defina o menor prazo de expiração que funcione para o seu caso de uso
* Revogue os PATs imediatamente se forem comprometidos
* Prefira chaves de API de usuários de serviço para qualquer automação compartilhada ou de produção

<div id="next-steps">
  ## Próximas etapas
</div>

* [Visão geral da autenticação](/pt-BR/api-reference/authentication) — entenda todo o modelo de autenticação
* [Início rápido do Teams](/pt-BR/api-reference/getting-started/teams-quickstart) — comece a usar usuários de serviço