Démarrage rapide : équipes

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.

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.

Étape 1 : Créer un utilisateur de service

Accédez à Settings > Service users de votre organisation
Cliquez sur Create service user
Choisissez un nom descriptif (par exemple, « CI Pipeline », « Monitoring Bot »)
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

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.

Étape 2 : Générer une API key

Après avoir créé l’utilisateur de service, cliquez sur Generate API key
Copiez immédiatement la clé — elle commence par cog_ et ne s’affichera plus
Stockez-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 d’API

Créez une session Devin :

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"}'

Retrouvez votre ID d’organisation sur la page Settings → Service Users.

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 pour plus de détails.

Étape 4 : Opérations courantes

Lister vos sessions

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

Envoyer un message à une session en cours

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"}'

Gérer Knowledge

# 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..."}'

Autorisations pour les utilisateurs de Teams

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.

Prochaines étapes

Parcourez les endpoints de l’Organization API dans la barre latérale
Consultez les flux courants pour les schémas d’intégration courants
Découvrez en détail le fonctionnement de l’authentification
Configurez des sessions programmées pour les tâches récurrentes

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

​Étape 2 : Générer une API key

​Étape 3 : Effectuez votre premier appel d’API

​Étape 4 : Opérations courantes

​Lister vos sessions

​Envoyer un message à une session en cours

​Gérer Knowledge

​Autorisations pour les utilisateurs de Teams

​Prochaines étapes

Étape 1 : Créer un utilisateur de service

Étape 2 : Générer une API key

Étape 3 : Effectuez votre premier appel d’API

Étape 4 : Opérations courantes

Lister vos sessions

Envoyer un message à une session en cours

Gérer Knowledge

Autorisations pour les utilisateurs de Teams

Prochaines étapes