> ## 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.

# Permissões e RBAC

> Referência de permissões para a Devin API

Cada endpoint da API é protegido por uma permissão específica atribuída à função (role) do usuário de serviço que faz a chamada. A permissão necessária para cada endpoint é documentada em sua página individual de referência da API. Esta página fornece um resumo de todas as permissões por escopo.

**URLs base:**

* `https://api.devin.ai/v3/organizations/*` — endpoints com escopo em uma única organização
* `https://api.devin.ai/v3/enterprise/*` — endpoints que exigem permissões em nível Enterprise

<Note>
  Clientes do **Devin Enterprise** com uma implantação dedicada devem substituir `api.devin.ai` pelo seu domínio de API personalizado (por exemplo, `api.your-company.devinenterprise.com`). Consulte o [guia de início rápido do Enterprise](/pt-BR/api-reference/getting-started/enterprise-quickstart) para obter detalhes de configuração.
</Note>

<Tip>
  Encontre o ID da sua organização na página **Settings → Service Users**.
</Tip>

<Note>
  Alguns endpoints de Enterprise operam em organizações específicas usando caminhos como
  `/v3/enterprise/organizations/{org_id}/...` (por exemplo, logs de auditoria e tags).
  Mesmo que incluam um parâmetro `org_id`, eles exigem permissões em nível **Enterprise**.
</Note>

<div id="enterprise-permissions">
  ## Permissões de Enterprise
</div>

| Permissão                    | Controles                                                                                                                                  |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `ReadAccountMeta`            | Próprio usuário (concedida a todos os usuários de serviço por padrão)                                                                      |
| `ManageEnterpriseSettings`   | Logs de auditoria, tags de organização                                                                                                     |
| `ManageOrganizations`        | CRUD de organizações, limites de grupos de organização                                                                                     |
| `ManageAccountMembership`    | Funções, usuários Enterprise, grupos de IdP Enterprise, associação de usuários de serviço Enterprise, registro de grupos de IdP Enterprise |
| `ManageAccountServiceUsers`  | Provisionamento de usuários de serviço (Enterprise)                                                                                        |
| `ManageAccountKnowledge`     | Notas do Knowledge (Enterprise)                                                                                                            |
| `ManageAccountPlaybooks`     | Playbooks (Enterprise)                                                                                                                     |
| `ManageGitIntegrations`      | Conexões Git, permissões Git                                                                                                               |
| `ManageBilling`              | Ciclos de consumo, detalhamento diário do consumo                                                                                          |
| `ViewAccountMetrics`         | Métricas de uso (DAU/WAU/MAU, PRs, sessões, pesquisas, usuários ativos), status da fila                                                    |
| `ViewEnterpriseInfraDetails` | Hipervisores                                                                                                                               |
| `ViewAccountSessions`        | Lista e detalhes de sessões (Enterprise, somente leitura)                                                                                  |
| `ManageAccountSessions`      | Enviar mensagens para sessões (Enterprise)                                                                                                 |

<div id="organization-permissions">
  ## Permissões da organização
</div>

| Permission               | Controls                                                       |
| ------------------------ | -------------------------------------------------------------- |
| `ManageOrgSecrets`       | CRUD de segredos                                               |
| `ManageOrgKnowledge`     | Notas no Knowledge (organização)                               |
| `ManageOrgPlaybooks`     | Playbooks (organização)                                        |
| `ManageOrgServiceUsers`  | Provisionamento de usuários de serviço (organização)           |
| `ManageOrgSchedules`     | Sessões agendadas                                              |
| `ViewOrgSessions`        | Lista e detalhes de sessões (organização, somente leitura)     |
| `ManageOrgSessions`      | Enviar mensagens, encerrar, arquivar sessões                   |
| `UseDevinSessions`       | Criar sessões                                                  |
| `ImpersonateOrgSessions` | Criar sessões em nome de outros usuários (`create_as_user_id`) |

<div id="permission-inheritance">
  ## Herança de permissões
</div>

**Usuários de serviço Enterprise** se autenticam pelos endpoints `/v3/enterprise/*` e podem operar em todas as organizações. Eles recebem funções em nível Enterprise e herdam automaticamente as permissões correspondentes em nível de organização em cada organização (por exemplo, `ViewAccountSessions` concede `ViewOrgSessions` em todas as organizações).

**Usuários de serviço da organização** têm escopo limitado a uma única organização e se autenticam apenas pelos endpoints `/v3/organizations/{org_id}/*`. Eles recebem funções em nível de organização.

<div id="creating-service-users">
  ## Criando usuários de serviço
</div>

Usuários de serviço são criados na interface do Devin:

1. **Usuários de serviço Enterprise**: Enterprise Settings → Service Users
2. **Usuários de serviço da organização**: Organization Settings → Service Users

Para obter instruções de configuração, consulte o [guia de início rápido para equipes](/pt-BR/api-reference/getting-started/teams-quickstart) ou o [guia de início rápido do Enterprise](/pt-BR/api-reference/getting-started/enterprise-quickstart).