A API v3 está atualmente em beta. Alguns endpoints podem mudar à medida que aprimoramos a API.
https://api.devin.ai/v3beta1/enterprise/*– endpoints que exigem permissões Enterprise (nível de conta)https://api.devin.ai/v3beta1/organizations/*– endpoints com escopo para uma única organização
Alguns endpoints Enterprise operam em organizações específicas, mas ainda assim são protegidos
por permissões em nível Enterprise. Eles usam caminhos como
/v3beta1/enterprise/organizations/{org_id}/...
(por exemplo, GET /v3beta1/enterprise/organizations/{org_id}/audit-logs).
Mesmo que incluam um parâmetro de caminho org_id, eles ainda exigem
permissões em nível Enterprise, como ManageEnterpriseSettings.Permissões e RBAC
Tipos de permissão
| Permission | Description | Endpoints |
|---|---|---|
ManageAccountKnowledge | Gerenciar notas do Knowledge em nível de Enterprise ou de organização | Endpoints de Notes (GET, POST, PUT, DELETE) |
ManageAccountPlaybooks | Gerenciar playbooks em nível de Enterprise ou de organização | Endpoints de Playbooks (GET, POST, PUT, DELETE) |
ManageEnterpriseSettings | Gerenciar configurações em todo o Enterprise, incluindo tags de organização | Endpoints de Tags, gerenciamento de organizações |
Escopos de Service Users
/v3beta1/enterprise/*.
Organization Service Users são limitados a uma organização específica e só podem acessar recursos dentro dessa organização. Eles usam endpoints em /v3beta1/organizations/{org_id}/*.
Criando usuários de serviço
- Enterprise Settings → Service Users: Crie usuários de serviço no nível Enterprise ou no nível da organização, com funções personalizadas
Self
Logs de auditoria
Logs de auditoria da Enterprise
Obtenha logs de auditoria em toda a Enterprise
Logs de auditoria da organização
Obtenha logs de auditoria de uma organização específica
Consumo
Ciclos de consumo
Veja resumos dos ciclos de consumo
Consumo diário
Obtenha o detalhamento diário do consumo
Por organização
Acompanhe o consumo por organização
Por usuário
Acompanhe o consumo por usuário
Por sessão
Acompanhe o consumo por sessão
Organizações
Listar Organizações
Ver todas as organizações
Criar Organização
Criar uma nova organização
Atualizar Organização
Atualizar configurações da organização
Excluir Organização
Excluir uma organização
Usuários de serviço
Listar usuários de serviço da Enterprise
Visualizar usuários de serviço da Enterprise
Criar usuário de serviço da Enterprise
Criar um usuário de serviço da Enterprise
Atualizar usuário de serviço da Enterprise
Atualizar um usuário de serviço da Enterprise
Excluir usuário de serviço da Enterprise
Excluir um usuário de serviço da Enterprise
Listar usuários de serviço da organização
Visualizar usuários de serviço da organização
Criar usuário de serviço da organização
Criar um usuário de serviço da organização
Usuários
Listar usuários da Enterprise
Ver usuários da Enterprise
Adicionar usuário à Enterprise
Adicionar um usuário à Enterprise
Atualizar usuário da Enterprise
Atualizar um usuário da Enterprise
Remover usuário da Enterprise
Remover um usuário da Enterprise
Listar usuários da organização
Ver usuários da organização
Adicionar usuário à organização
Adicionar um usuário a uma organização
Grupos de IdP
Listar grupos da Enterprise
Visualizar grupos de IdP da Enterprise
Adicionar grupo à Enterprise
Adicionar um grupo de IdP à Enterprise
Listar grupos da organização
Visualizar grupos de IdP da organização
Adicionar grupo à organização
Adicionar um grupo de IdP a uma organização
Permissões do Git
Listar permissões
Visualize as permissões do Git de uma organização
Adicionar permissão
Adicione uma permissão do Git
Remover permissão
Remova uma permissão do Git
Notas
Listar notas Enterprise
Visualizar notas de conhecimento no nível Enterprise
Criar nota Enterprise
Criar uma nova nota no nível Enterprise
Listar notas da organização
Visualizar notas de conhecimento da organização
Criar nota da organização
Criar uma nova nota da organização
Playbooks
Listar Playbooks Enterprise
Visualizar playbooks Enterprise
Criar Playbook Enterprise
Criar novo playbook Enterprise
Listar Playbooks da Organização
Visualizar playbooks da organização
Criar Playbook da Organização
Criar novo playbook da organização
Sessões
Listar Tags
Visualizar tags de uma organização
Adicionar Tags
Adicionar tags a uma organização
Substituir Tags
Substituir todas as tags de uma organização
Excluir Tag
Remover uma tag específica
Funções e métricas
Listar funções
Ver funções disponíveis
Métricas de uso
Obter métricas de uso do Enterprise
Métricas da organização
Obter métricas de uso da organização
Exemplos de uso
Ver exemplos de código
Confira exemplos de código e casos de uso comuns da API v3