> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide : Enterprise

> Commencez à utiliser l'API Devin en tant qu'utilisateur Enterprise, avec RBAC et prise en charge multi‑organisation

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.

<Note>
  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](/fr/api-reference/getting-started/teams-quickstart) est plus simple.
</Note>

<Note>
  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.
</Note>

<div id="understanding-service-user-scopes">
  ## Comprendre les périmètres des utilisateurs de service
</div>

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.

<div id="step-1-create-a-service-user">
  ## Étape 1 : Créer un compte de service
</div>

<div id="enterprise-service-user-cross-org-access">
  ### Utilisateur de service Enterprise (accès multi-organisations)
</div>

1. Accédez à **Enterprise settings > Service users**
2. Cliquez sur **Create service user**
3. Choisissez un nom (par exemple : « Analytics Dashboard », « Org Provisioning Bot »)
4. Attribuez un rôle Enterprise avec les autorisations dont votre intégration a besoin

<div id="organization-service-user-single-org-access">
  ### Utilisateur de service d’organisation (accès à une seule organisation)
</div>

1. Accédez à **Settings > Service users** dans l’organisation cible
2. Cliquez sur **Create service user**
3. Choisissez un nom et attribuez-lui un rôle au niveau de l’organisation

<Tip>
  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.
</Tip>

<div id="step-2-generate-an-api-key">
  ## Étape 2 : Générer une API key
</div>

1. Après avoir créé l’utilisateur de service, cliquez sur **Generate API key**
2. Copiez immédiatement la clé — elle commence par `cog_` et ne sera plus affichée
3. Conservez-la en toute sécurité en tant que variable d’environnement :

```bash theme={null}
export DEVIN_API_KEY="cog_your_key_here"
```

<div id="step-3-make-your-first-api-call">
  ## Étape 3 : Effectuez votre premier appel à l’API
</div>

<div id="enterprise-endpoint-example">
  ### Exemple d’endpoint Enterprise
</div>

Lister toutes les organisations de votre compte Enterprise :

```bash theme={null}
curl "https://api.devin.ai/v3/enterprise/organizations" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<div id="organization-endpoint-example">
  ### Exemple de point de terminaison d’organisation
</div>

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

```bash theme={null}
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"}'
```

<div id="permissions-and-rbac">
  ## Autorisations et RBAC
</div>

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](/fr/api-reference/v3/overview#enterprise-permissions).

<div id="common-enterprise-workflows">
  ## Flux de travail d'entreprise courants
</div>

<div id="monitor-consumption-across-orgs">
  ### Surveiller la consommation dans toutes les organisations
</div>

```bash theme={null}
# 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"
```

<div id="audit-log-retrieval">
  ### Consultation du journal d’audit
</div>

```bash theme={null}
curl "https://api.devin.ai/v3/enterprise/audit-logs" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<div id="manage-users-across-organizations">
  ### Gérer les utilisateurs au sein de plusieurs organisations
</div>

```bash theme={null}
# 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"
```

<div id="next-steps">
  ## Prochaines étapes
</div>

* Parcourez la [référence complète des autorisations API](/fr/api-reference/v3/overview)
* Approfondissez le sujet de l’[authentification](/fr/api-reference/authentication)
* Configurez la [pagination](/fr/api-reference/concepts/pagination) pour des ensembles de résultats volumineux
* Consultez le [guide de migration](/fr/api-reference/getting-started/migration-guide) si vous migrez depuis la v1/v2