> ## 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.

# Vue d’ensemble de l’API

> Découvrez comment interagir avec Devin par programmation à l’aide de nos API REST

L’API Devin vous permet d’intégrer Devin à vos applications, d’automatiser vos workflows et de créer des outils puissants. Utilisez des **utilisateurs de service** avec un contrôle d’accès basé sur les rôles pour garantir un accès à l’API sécurisé et traçable.

<div id="getting-started">
  ## Bien démarrer
</div>

<CardGroup cols={2}>
  <Card title="Démarrage rapide Teams" icon="rocket" href="/fr/api-reference/getting-started/teams-quickstart">
    Pour les équipes et les organisations standard. Créez un utilisateur de service et effectuez votre premier appel d'API en quelques minutes.
  </Card>

  <Card title="Démarrage rapide Enterprise" icon="building" href="/fr/api-reference/getting-started/enterprise-quickstart">
    Pour les clients Enterprise avec RBAC, prise en charge multi‑organisation et autorisations avancées.
  </Card>
</CardGroup>

<Tip>
  **Quel parcours dois‑je choisir ?** La plupart des clients devraient commencer par le démarrage rapide Teams. Choisissez Enterprise si vous gérez plusieurs organisations, utilisez le SSO (Single Sign-On, authentification unique) ou avez besoin de rôles personnalisés et de RBAC.
</Tip>

<div id="api-structure">
  ## Structure de l'API
</div>

L'API est organisée en deux périmètres :

<div id="organization-api">
  ### API d’organisation
</div>

**URL de base :** `https://api.devin.ai/v3/organizations/*`

Pour gérer les ressources d’une organisation donnée — sessions, Knowledge, playbooks, secrets, etc. La plupart des intégrations commencent ici.

<div id="enterprise-api">
  ### API Enterprise
</div>

**URL de base :** `https://api.devin.ai/v3/enterprise/*`

Pour la gestion multi‑organisation : analyses, journaux d’audit, gestion des utilisateurs, facturation et infrastructure. Disponible pour les clients Enterprise.

Les deux scopes utilisent des identifiants d’utilisateur de service (préfixe `cog_`). Voir [Authentification](/fr/api-reference/authentication) pour la configuration.

<div id="session-attribution">
  ## Attribution de session
</div>

Les comptes de service sont des identités distinctes des utilisateurs humains, mais vous pouvez **créer des sessions au nom de n’importe quel utilisateur** de votre organisation à l’aide du paramètre `create_as_user_id`. Cela signifie que les sessions apparaissent dans la liste de sessions de cet utilisateur et sont comptabilisées dans son utilisation — exactement comme s’il les avait créées lui-même.

```bash theme={null}
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": "Fix the login bug in issue #42",
    "create_as_user_id": "user_abc123"
  }'
```

<Tip>
  **Vous utilisiez des API keys personnelles ?** Avec les versions v1/v2, les API keys personnelles créaient automatiquement des sessions sous votre identité d’utilisateur. Avec v3, utilisez un utilisateur de service + `create_as_user_id` pour obtenir le même comportement — avec en plus le RBAC, les journaux d’audit et une gestion centralisée des clés. Le rôle de l’utilisateur de service doit inclure l’autorisation `ImpersonateOrgSessions`.
</Tip>

<Note>
  **Les Personal Access Tokens (PAT) arrivent bientôt.** Les PAT vous permettront de vous authentifier directement en tant qu’utilisateur avec l’API v3 — sans avoir besoin d’utilisateur de service ni de `create_as_user_id`. Les sessions vous seront automatiquement attribuées. Restez à l’écoute concernant leur disponibilité.
</Note>

Vous pouvez trouver les identifiants utilisateurs via le point de terminaison [List users](/fr/api-reference/v3/users/organizations-members-users) ou dans l’interface utilisateur de Devin, sous les paramètres des membres de l’organisation.

<div id="legacy-apis-v1-and-v2">
  ## Anciennes API (v1 et v2)
</div>

Les API v1 et v2 continuent de fonctionner pendant la période de retrait, mais ne reçoivent plus de nouvelles fonctionnalités. Nous recommandons de migrer vers l'API actuelle pour le contrôle d'accès basé sur les rôles, l'attribution des sessions et les nouvelles fonctionnalités.

* [Documentation de l'API v1](/fr/api-reference/v1/overview) — gestion des sessions avec d'anciennes API keys
* [Documentation de l'API v2](/fr/api-reference/v2/overview) — gestion Enterprise avec d'anciennes API keys
* [Guide de migration](/fr/api-reference/getting-started/migration-guide) — migration étape par étape à partir de v1/v2

***

<div id="error-handling">
  ## Gestion des erreurs
</div>

Toutes les API utilisent les codes d'état HTTP standard :

* `200 OK`: Requête réussie
* `201 Created`: Ressource créée avec succès
* `400 Bad Request`: Paramètres de la requête non valides
* `401 Unauthorized`: API key manquante ou invalide
* `403 Forbidden`: Droits insuffisants
* `404 Not Found`: Ressource introuvable
* `429 Too Many Requests`: Limite de requêtes dépassée
* `500 Internal Server Error`: Erreur interne du serveur

<div id="support">
  ## Support
</div>

Pour toute question concernant l’API ou pour signaler un problème, contactez-nous à l’adresse [support@cognition.ai](mailto:support@cognition.ai).