> ## 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 : équipes

> Commencez à utiliser l’API Devin en tant qu’utilisateur d’équipe ou d’organisation standard

Ce guide vous accompagne dans la configuration de l’accès à l’API pour les **équipes et les organisations standard** (hors Enterprise). Vous allez créer un compte de service, récupérer vos identifiants et effectuer votre premier appel d’API en quelques minutes.

<Note>
  Si vous utilisez l’offre Enterprise avec plusieurs organisations, des rôles personnalisés ou le SSO (Single Sign-On, authentification unique), consultez plutôt le [démarrage rapide Enterprise](/fr/api-reference/getting-started/enterprise-quickstart).
</Note>

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

1. Accédez à **Settings > Service users** de votre organisation
2. Cliquez sur **Create service user**
3. Choisissez un nom descriptif (par exemple, « CI Pipeline », « Monitoring Bot »)
4. Sélectionnez un rôle :
   * **Admin** — accès complet pour gérer les sessions, Knowledge, playbooks, secrets et paramètres
   * **Member** — peut créer et gérer les sessions Devin, voir les ressources

<Tip>
  Utilisez le rôle **Member** pour la plupart des automatisations. N'utilisez le rôle **Admin** que si votre intégration doit gérer les paramètres de l'organisation ou d'autres utilisateurs.
</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 s’affichera plus
3. Stockez-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 d’API
</div>

Créez une session Devin :

```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": "Create a simple Python script that prints Hello World"}'
```

<Tip>
  Retrouvez votre ID d’organisation sur la page **Settings → Service Users**.
</Tip>

<Note>
  **Vous voulez que les sessions soient attribuées à votre utilisateur ?** Par défaut, les sessions sont attribuées à l’utilisateur de service. Pour créer des sessions au nom d’un utilisateur spécifique (afin qu’elles apparaissent dans la liste de sessions de cet utilisateur), ajoutez `"create_as_user_id": "user_abc123"` au corps de la requête. Cela nécessite le rôle **Admin** (qui inclut l’autorisation `ImpersonateOrgSessions`). Consultez [Attribution des sessions](/fr/api-reference/overview#session-attribution) pour plus de détails.
</Note>

<div id="step-4-common-operations">
  ## Étape 4 : Opérations courantes
</div>

<div id="list-your-sessions">
  ### Lister vos sessions
</div>

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

<div id="send-a-message-to-a-running-session">
  ### Envoyer un message à une session en cours
</div>

```bash theme={null}
export SESSION_ID="your_session_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions/$SESSION_ID/messages" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Please also add unit tests"}'
```

<div id="manage-knowledge">
  ### Gérer Knowledge
</div>

```bash theme={null}
# Lister les entrées Knowledge
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Créer une entrée Knowledge
curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Coding standards", "trigger_description": "When writing code", "body": "Use TypeScript strict mode..."}'
```

<div id="permissions-for-teams-users">
  ## Autorisations pour les utilisateurs de Teams
</div>

Les organisations Teams ont un modèle d'autorisations simple :

| Rôle       | Peut créer des sessions | Peut gérer les ressources           | Peut gérer les paramètres |
| ---------- | ----------------------- | ----------------------------------- | ------------------------- |
| **Membre** | Oui                     | Oui (Knowledge, playbooks, secrets) | Non                       |
| **Admin**  | Oui                     | Oui                                 | Oui                       |

Pour un contrôle d'accès basé sur les rôles (RBAC) plus fin, consultez le [guide de démarrage rapide Enterprise](/fr/api-reference/getting-started/enterprise-quickstart).

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

* Parcourez les endpoints de l’**Organization API** dans la barre latérale
* Consultez les [flux courants](/fr/api-reference/common-flows) pour les schémas d’intégration courants
* Découvrez en détail le fonctionnement de l’[authentification](/fr/api-reference/authentication)
* Configurez des [sessions programmées](/fr/api-reference/v3/schedules/organizations-schedules) pour les tâches récurrentes