L’API v3 est actuellement en bêta. Certains points de terminaison peuvent changer à mesure que nous améliorons l’API.
https://api.devin.ai/v3beta1/enterprise/*– points de terminaison qui nécessitent des autorisations de niveau Enterprisehttps://api.devin.ai/v3beta1/organizations/*– points de terminaison limités à une seule organisation
Certains points de terminaison Enterprise s’appliquent à des organisations spécifiques, mais restent protégés
par des autorisations au niveau Enterprise. Ils utilisent des chemins du type
/v3beta1/enterprise/organizations/{org_id}/...
(par exemple, GET /v3beta1/enterprise/organizations/{org_id}/audit-logs).
Même s’ils incluent un paramètre de chemin org_id, ils exigent toujours
des autorisations au niveau Enterprise telles que ManageEnterpriseSettings.Autorisations et RBAC
/v3beta1/enterprise/*, et les autorisations au niveau de l’organisation contrôlent les endpoints /v3beta1/organizations/{org_id}/*. Un utilisateur de service Enterprise disposant d’une autorisation au niveau Enterprise hérite automatiquement de l’autorisation correspondante au niveau de l’organisation pour l’ensemble des organisations.
Enterprise permissions
| Permission | Contrôles |
|---|---|
ReadAccountMeta | Compte de l’utilisateur (accordée par défaut à tous les utilisateurs de service) |
ManageEnterpriseSettings | Journaux d’audit, étiquettes d’organisation |
ManageOrganizations | CRUD des organisations, limites des groupes d’organisation |
ManageAccountMembership | Rôles, utilisateurs Enterprise, groupes IdP Enterprise, appartenance des utilisateurs de service Enterprise, enregistrement des groupes IdP Enterprise |
ManageAccountServiceUsers | Provisionnement des utilisateurs de service (Enterprise) |
ManageAccountKnowledge | Notes Knowledge (Enterprise) |
ManageAccountPlaybooks | Playbooks (Enterprise) |
ManageGitIntegrations | Connexions Git, autorisations Git |
ManageBilling | Cycles de consommation, ventilation quotidienne de la consommation |
ViewAccountMetrics | Indicateurs d’utilisation (DAU/WAU/MAU, PRs, sessions, recherches, utilisateurs actifs), état de la file d’attente |
ViewEnterpriseInfraDetails | Hyperviseurs |
ViewAccountSessions | Liste et détails des sessions (Enterprise, en lecture seule) |
ManageAccountSessions | Envoi de messages aux sessions (Enterprise) |
ViewAccountSearches | Recherches (Enterprise) |
Autorisations d’organisation
| Autorisation | Contrôles |
|---|---|
ManageOrgSecrets | CRUD sur les secrets |
ManageOrgKnowledge | Notes Knowledge (organisation) |
ManageOrgPlaybooks | Playbooks (organisation) |
ManageOrgServiceUsers | Provisionnement des comptes de service (organisation) |
ViewOrgSessions | Liste et détails des sessions (organisation, en lecture seule) |
ManageOrgSessions | Envoyer des messages, mettre fin aux sessions, les archiver |
UseDevinSessions | Créer des sessions |
ImpersonateOrgSessions | Créer des sessions au nom d’autres utilisateurs (create_as_user_id) |
ViewOrgSearches | Recherches (organisation) |
Portée des utilisateurs de service
/v3beta1/enterprise/* et peuvent agir sur l’ensemble des organisations. Ils se voient attribuer des rôles au niveau Enterprise et héritent automatiquement, dans chaque organisation, des autorisations correspondantes au niveau de l’organisation (par exemple, ViewAccountSessions accorde ViewOrgSessions dans toutes les organisations).
Les utilisateurs de service d’organisation sont limités à une seule organisation et s’authentifient uniquement via les endpoints /v3beta1/organizations/{org_id}/*. Ils se voient attribuer des rôles au niveau de l’organisation.
Création d’utilisateurs de service
- UI : Enterprise Settings → Service Users — créez des utilisateurs de service au niveau Enterprise ou au niveau de l’org avec des rôles personnalisés et générez des jetons d’API.
- API :
POST /v3beta1/enterprise/service-usersouPOST /v3beta1/organizations/{org_id}/service-users— provisionnez des utilisateurs de service par programmation avec un rôle et un TTL spécifiés. Les autorisations du nouvel utilisateur doivent être un sous-ensemble des autorisations de l’appelant (l’élévation de privilèges est empêchée).
Self
Journaux d’audit
Journaux d’audit Enterprise
Obtenez les journaux d’audit à l’échelle de l’entreprise
Journaux d’audit d’organisation
Obtenez les journaux d’audit pour une organisation spécifique
Consommation
Cycles de consommation
Consultez les résumés des cycles de consommation
Consommation quotidienne
Consultez le détail de la consommation quotidienne
Par organisation
Suivez la consommation par organisation
Par utilisateur
Suivez la consommation par utilisateur
Par session
Suivez la consommation par session
Organisations
Liste des organisations
Afficher toutes les organisations
Créer une organisation
Créer une nouvelle organisation
Mettre à jour une organisation
Mettre à jour les paramètres de l’organisation
Supprimer une organisation
Supprimer une organisation
Utilisateurs de service
Afficher la liste des utilisateurs de service de l’entreprise
Afficher les utilisateurs de service de l’entreprise
Créer un utilisateur de service pour l’entreprise
Créer un utilisateur de service pour l’entreprise
Mettre à jour un utilisateur de service pour l’entreprise
Mettre à jour un utilisateur de service pour l’entreprise
Supprimer un utilisateur de service pour l’entreprise
Supprimer un utilisateur de service pour l’entreprise
Afficher la liste des utilisateurs de service de l’organisation
Afficher les utilisateurs de service de l’organisation
Créer un utilisateur de service pour l’organisation
Créer un utilisateur de service pour l’organisation
Utilisateurs
Lister les utilisateurs Enterprise
Afficher les utilisateurs Enterprise
Ajouter un utilisateur Enterprise
Ajouter un utilisateur à l’Enterprise
Mettre à jour un utilisateur Enterprise
Mettre à jour un utilisateur Enterprise
Supprimer un utilisateur Enterprise
Supprimer un utilisateur de l’Enterprise
Lister les utilisateurs d’organisation
Afficher les utilisateurs d’organisation
Ajouter un utilisateur d’organisation
Ajouter un utilisateur à une organisation
Groupes IdP
Lister les groupes d’entreprise enregistrés
Lister les groupes IdP enregistrés pour cette entreprise
Enregistrer des groupes d’entreprise
Enregistrer des groupes IdP pour cette entreprise
Supprimer un groupe d’entreprise enregistré
Supprimer un groupe IdP enregistré pour cette entreprise
Lister les groupes d’entreprise
Afficher les affectations de groupes IdP au niveau entreprise
Affecter un groupe d’entreprise
Affecter un rôle de groupe IdP au niveau entreprise
Lister les groupes d’organisation
Afficher les affectations de groupes IdP au niveau organisation
Affecter un groupe d’organisation
Affecter un rôle de groupe IdP au niveau organisation
Autorisations Git
Lister les autorisations
Consulter les autorisations Git d’une organisation
Ajouter une autorisation
Ajouter une autorisation Git
Supprimer une autorisation
Supprimer une autorisation Git
Notes
Lister les notes Enterprise
Afficher les notes Knowledge au niveau Enterprise
Créer une note Enterprise
Créer une nouvelle note au niveau Enterprise
Lister les notes d'organisation
Afficher les notes Knowledge au niveau de l’organisation
Créer une note d'organisation
Créer une nouvelle note au niveau de l’organisation
Playbooks
Répertorier les playbooks Enterprise
Afficher les playbooks Enterprise
Créer un playbook Enterprise
Créer un nouveau playbook Enterprise
Répertorier les playbooks d’organisation
Afficher les playbooks d’organisation
Créer un playbook d’organisation
Créer un nouveau playbook d’organisation
Sessions
Lister les sessions
Afficher les sessions de l’organisation
Créer une session
Créer une nouvelle session
Terminer une session
Terminer une session active
Archiver une session
Archiver une session pour référence future
Consulter les tags
Afficher les tags d’une organisation
Ajouter des tags
Ajouter des tags à une organisation
Remplacer les tags
Remplacer tous les tags d’une organisation
Supprimer un tag
Supprimer un tag spécifique
Rôles et métriques
Lister les rôles
Afficher les rôles disponibles
Métriques d'utilisation Enterprise
Afficher les métriques d’utilisation Enterprise
Métriques d'utilisation de l'organisation
Afficher les métriques d’utilisation de l’organisation
Exemples d’utilisation
Voir des exemples de code
Consultez des exemples de code et des cas d’utilisation courants de l’API v3