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 > Devin API de votre organisation et ouvrez l’onglet Service users
Cliquez sur Provision service user
Choisissez un nom d’affichage descriptif (par exemple, « CI Pipeline », « Monitoring Bot »)
Sélectionnez un rôle :
- Admin — accès complet, y compris aux paramètres de l’organisation et à la gestion des membres
- Member — peut créer et gérer les sessions Devin et la plupart des ressources de l’organisation, mais pas les paramètres de l’organisation ni la gestion des membres

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 : 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 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 en haut de la page Settings → Devin API.

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": "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 automatisations programmées pour les tâches récurrentes

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

Étape 1 : Créer un utilisateur de service

Étape 2 : Copier votre 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 : Copier votre 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 : Copier votre 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