Passer au contenu principal
Chaque endpoint de l’API est protégé par une autorisation spécifique associée au rôle de l’utilisateur de service appelant. L’autorisation requise pour chaque endpoint est indiquée sur sa page de référence API dédiée. Cette page fournit un aperçu de toutes les autorisations par périmètre. URLs de base :
  • https://api.devin.ai/v3/organizations/* — endpoints limités à une seule organisation
  • https://api.devin.ai/v3/enterprise/* — endpoints qui nécessitent des autorisations de niveau Enterprise
Les clients Devin Enterprise disposant d’un déploiement dédié doivent remplacer api.devin.ai par leur domaine API personnalisé (par exemple, api.your-company.devinenterprise.com). Consultez le guide de démarrage rapide Enterprise pour plus de détails sur la configuration.
Trouvez l’identifiant de votre organisation sur la page Settings → Service Users.
Certains endpoints Enterprise opèrent sur des organisations spécifiques en utilisant des chemins comme /v3/enterprise/organizations/{org_id}/... (par exemple, journaux d’audit et tags). Même s’ils incluent un paramètre org_id, ils nécessitent des autorisations de niveau Enterprise.

​
Enterprise permissions

PermissionContrôles
ReadAccountMetaCompte de l’utilisateur (accordée par défaut à tous les utilisateurs de service)
ManageEnterpriseSettingsJournaux d’audit, étiquettes d’organisation
ManageOrganizationsCRUD des organisations, limites des groupes d’organisation
ManageAccountMembershipRôles, utilisateurs Enterprise, groupes IdP Enterprise, appartenance des utilisateurs de service Enterprise, enregistrement des groupes IdP Enterprise
ManageAccountServiceUsersProvisionnement des utilisateurs de service (Enterprise)
ManageAccountKnowledgeNotes Knowledge (Enterprise)
ManageAccountPlaybooksPlaybooks (Enterprise)
ManageGitIntegrationsConnexions Git, autorisations Git
ManageBillingCycles de consommation, ventilation quotidienne de la consommation
ViewAccountMetricsIndicateurs d’utilisation (DAU/WAU/MAU, PRs, sessions, recherches, utilisateurs actifs), état de la file d’attente
ViewEnterpriseInfraDetailsHyperviseurs
ViewAccountSessionsListe et détails des sessions (Enterprise, en lecture seule)
ManageAccountSessionsEnvoi de messages aux sessions (Enterprise)

​
Autorisations d’organisation

AutorisationContrôles
ManageOrgSecretsCRUD sur les secrets
ManageOrgKnowledgeNotes Knowledge (organisation)
ManageOrgPlaybooksPlaybooks (organisation)
ManageOrgServiceUsersProvisionnement des comptes de service (organisation)
ManageOrgSchedulesSessions planifiées
ViewOrgSessionsListe et détails des sessions (organisation, en lecture seule)
ManageOrgSessionsEnvoyer des messages, mettre fin aux sessions, les archiver
UseDevinSessionsCréer des sessions
ImpersonateOrgSessionsCréer des sessions au nom d’autres utilisateurs (create_as_user_id)

​
Héritage des autorisations

Les utilisateurs de service Enterprise s’authentifient via les endpoints /v3/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 /v3/organizations/{org_id}/*. Ils se voient attribuer des rôles au niveau de l’organisation.

​
Création d’utilisateurs de service

Les utilisateurs de service sont créés dans l’interface Devin :
  1. Utilisateurs de service Enterprise : Enterprise settings → Service Users
  2. Utilisateurs de service d’organisation : Organization settings → Service Users
Pour la procédure de configuration, consultez le guide de démarrage rapide pour les équipes ou le guide de démarrage rapide Enterprise.