Démarrage rapide : Enterprise

Ce guide vous explique comment configurer l’accès à l’API pour les organisations Enterprise avec rôles personnalisés, RBAC et prise en charge multi‑organisation.

Si vous êtes sur un plan Teams avec une seule organisation et que vous n’avez pas besoin de rôles personnalisés, le démarrage rapide Teams est plus simple.

Si vous êtes client Devin Enterprise avec un déploiement dédié, vous devrez remplacer api.devin.ai dans toutes les URL d’API par le domaine d’API personnalisé de votre organisation (par exemple : api.your-company.devinenterprise.com). Contactez votre administrateur Devin ou le support Cognition si vous n’êtes pas sûr de votre domaine d’API.

Comprendre les périmètres des utilisateurs de service

Les clients Enterprise peuvent créer des utilisateurs de service à deux niveaux :

Périmètre	URL de base	Cas d’usage
Enterprise	`/v3/enterprise/*`	Gestion inter-organisations, analyses, journaux d’audit, gestion des membres
Organization	`/v3/organizations/{org_id}/*`	Sessions, Knowledge, playbooks, secrets au sein d’une seule organisation

Un utilisateur de service Enterprise disposant de droits au niveau Enterprise hérite automatiquement des droits organisationnels correspondants dans toutes les organisations.

Étape 1 : Créer un compte de service

Utilisateur de service Enterprise (accès inter-organisations)

Accédez à Enterprise settings > Devin API et ouvrez l’onglet Service users
Cliquez sur Provision > Enterprise service user
Choisissez un nom d’affichage (par exemple : « Analytics Dashboard », « Org Provisioning Bot »)
Attribuez un rôle Enterprise avec les autorisations dont votre intégration a besoin, puis choisissez une date d’expiration

Utilisateur de service d’organisation (accès à une seule organisation)

Accédez à Settings > Devin API dans l’organisation cible et ouvrez l’onglet Service users
Cliquez sur Provision service user
Choisissez un nom d’affichage, attribuez un rôle au niveau de l’organisation et choisissez une expiration

Vous pouvez également provisionner un utilisateur de service d’organisation depuis Enterprise settings > Devin API en cliquant sur Provision > Organization service user et en sélectionnant l’organisation cible.

Suivez le principe du moindre privilège : créez des utilisateurs de service à portée d’organisation lorsque votre intégration n’a besoin que d’accéder à une seule organisation. Utilisez des utilisateurs de service Enterprise uniquement pour les workflows inter-organisations.

Étape 2 : Copier votre API key

Après avoir provisionné l’utilisateur de service, sa clé d’API s’affiche dans une boîte de dialogue
Copiez immédiatement la clé — elle commence par cog_ et ne sera plus affichée
Conservez-la en toute sécurité en tant que variable d’environnement :

export DEVIN_API_KEY="cog_your_key_here"

Étape 3 : Effectuez votre premier appel à l’API

Exemple d’endpoint Enterprise

Lister toutes les organisations de votre compte Enterprise :

curl "https://api.devin.ai/v3/enterprise/organizations" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

Exemple de point de terminaison d’organisation

Créez une session Devin dans une organisation donnée :

export DEVIN_ORG_ID="your_org_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Implement the feature described in JIRA-123"}'

Autorisations et RBAC

Chaque endpoint d’API est protégé par une autorisation spécifique. L’autorisation requise est indiquée sur la page de référence API de chaque endpoint. Les autorisations sont réparties en deux périmètres :

Autorisations Enterprise — contrôlent les endpoints /v3/enterprise/* (par exemple : ManageOrganizations, ManageBilling, ViewAccountMetrics)
Autorisations d’organisation — contrôlent les endpoints /v3/organizations/{org_id}/* (par exemple : UseDevinSessions, ManageOrgSecrets, ManageOrgPlaybooks)

Un utilisateur de service Enterprise disposant d’une autorisation au niveau Enterprise hérite automatiquement de l’autorisation d’organisation correspondante pour l’ensemble des organisations. Par exemple, ViewAccountSessions accorde ViewOrgSessions dans chaque organisation. Pour la liste complète des autorisations, consultez la documentation sur les autorisations et le RBAC.

Flux de travail d’entreprise courants

Surveiller la consommation dans toutes les organisations

# Obtenir la répartition quotidienne de la consommation (utilise des horodatages Unix — exemple : du 1er janv. au 31 janv. 2025)
curl "https://api.devin.ai/v3/enterprise/consumption/daily?time_after=1735689600&time_before=1738368000" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

Consultation du journal d’audit

curl "https://api.devin.ai/v3/enterprise/audit-logs" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

Gérer les utilisateurs au sein de plusieurs organisations

# Lister les utilisateurs Enterprise
curl "https://api.devin.ai/v3/enterprise/members/users" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Lister les utilisateurs d'une organisation spécifique
curl "https://api.devin.ai/v3/enterprise/organizations/$DEVIN_ORG_ID/members/users" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

Prochaines étapes

Parcourez la référence complète des autorisations API
Approfondissez le sujet de l’authentification
Configurez la pagination pour des ensembles de résultats volumineux
Consultez le guide de migration si vous migrez depuis la v1/v2

Premiers pas

Concepts

Cycle de vie de l’agent

Gestion du contexte

Gestion de l’environnement

Automatisation

Intégrations

Analyse

Observabilité

Devin pour la sécurité

Infrastructure

Identité et accès

Configuration

Ancienne API v1

Ancienne API v2

Démarrage rapide : Enterprise

Comprendre les périmètres des utilisateurs de service

Étape 1 : Créer un compte de service

Utilisateur de service Enterprise (accès inter-organisations)

Utilisateur de service d’organisation (accès à une seule organisation)

Étape 2 : Copier votre API key

Étape 3 : Effectuez votre premier appel à l’API

Exemple d’endpoint Enterprise

Exemple de point de terminaison d’organisation

Autorisations et RBAC

Flux de travail d’entreprise courants

Surveiller la consommation dans toutes les organisations

Consultation du journal d’audit

Gérer les utilisateurs au sein de plusieurs organisations

Prochaines étapes

​Comprendre les périmètres des utilisateurs de service

​Étape 1 : Créer un compte de service

​Utilisateur de service Enterprise (accès inter-organisations)

​Utilisateur de service d’organisation (accès à une seule organisation)

​Étape 2 : Copier votre API key

​Étape 3 : Effectuez votre premier appel à l’API

​Exemple d’endpoint Enterprise

​Exemple de point de terminaison d’organisation

​Autorisations et RBAC

​Flux de travail d’entreprise courants

​Surveiller la consommation dans toutes les organisations

​Consultation du journal d’audit

​Gérer les utilisateurs au sein de plusieurs organisations

​Prochaines étapes

Comprendre les périmètres des utilisateurs de service

Étape 1 : Créer un compte de service

Utilisateur de service Enterprise (accès inter-organisations)

Utilisateur de service d’organisation (accès à une seule organisation)

Étape 2 : Copier votre API key

Étape 3 : Effectuez votre premier appel à l’API

Exemple d’endpoint Enterprise

Exemple de point de terminaison d’organisation

Autorisations et RBAC

Flux de travail d’entreprise courants

Surveiller la consommation dans toutes les organisations

Consultation du journal d’audit

Gérer les utilisateurs au sein de plusieurs organisations

Prochaines étapes