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

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 para obter detalhes de configuração.

Encontre o ID da sua organização na página Settings → Service Users.

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.

​

Permissões de Enterprise

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)

​

Permissões da organização

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)

​

Herança de permissões

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.

​

Criando usuários de serviço

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 ou o guia de início rápido do Enterprise.