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

# Présentation de l’API v1 (ancienne version)

> Gestion des sessions et automatisation essentielles avec accès dans le périmètre de l’organisation

<Warning>
  Cette version de l’API est obsolète. Utilisez l’[API v3](/fr/api-reference/v3/overview) avec l’authentification par utilisateur de service. Consultez le [guide de migration](/fr/api-reference/getting-started/migration-guide) pour des instructions détaillées, étape par étape.
</Warning>

L’API v1 fournit les fonctionnalités de base pour créer et gérer des sessions Devin, ainsi que des ressources associées comme les secrets, les connaissances et les playbooks.

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

**Authentification :** clés API personnelles ou de service ([en savoir plus](/fr/api-reference/authentication))

<div id="permissions">
  ## Autorisations
</div>

L'API v1 utilise une authentification au niveau de l'organisation. Les API keys sont associées à une paire spécifique `(org_id, user_id)` et donnent accès aux ressources de cette organisation. L'API v1 n'utilise pas le système RBAC complet : l'accès est déterminé uniquement par la portée d'organisation de l'API key.

Pour un contrôle RBAC plus fin, utilisez plutôt l'[Organization API](/fr/api-reference/v3/overview).

<div id="sessions">
  ## Sessions
</div>

Gérez les sessions Devin et interagissez avec elles :

<CardGroup cols={2}>
  <Card title="Afficher les sessions" icon="list" href="/fr/api-reference/v1/sessions/list-sessions">
    Afficher toutes les sessions Devin en cours pour votre organisation
  </Card>

  <Card title="Créer une session" icon="plus" href="/fr/api-reference/v1/sessions/create-a-new-devin-session">
    Créer une nouvelle session Devin avec une description de tâche et des paramètres facultatifs
  </Card>

  <Card title="Afficher les détails d'une session" icon="circle-info" href="/fr/api-reference/v1/sessions/retrieve-details-about-an-existing-session">
    Consulter des informations sur l'état et les résultats d'une session existante
  </Card>

  <Card title="Envoyer un message" icon="message" href="/fr/api-reference/v1/sessions/send-a-message-to-an-existing-devin-session">
    Interagir avec une session active en envoyant des messages à Devin
  </Card>

  <Card title="Téléverser des fichiers" icon="upload" href="/fr/api-reference/v1/attachments/upload-files-for-devin-to-work-with">
    Téléverser des fichiers que Devin pourra utiliser pendant les sessions
  </Card>

  <Card title="Mettre à jour les tags de session" icon="tags" href="/fr/api-reference/v1/sessions/update-session-tags">
    Mettre à jour les tags associés à une session Devin
  </Card>
</CardGroup>

<div id="secrets">
  ## Secrets
</div>

Gérez les secrets et les identifiants pour votre organisation :

<CardGroup cols={2}>
  <Card title="Liste des secrets" icon="key" href="/fr/api-reference/v1/secrets/list-secrets">
    Afficher les métadonnées de tous les secrets de votre organisation
  </Card>

  <Card title="Supprimer un secret" icon="trash" href="/fr/api-reference/v1/secrets/delete-secret">
    Supprimer définitivement un secret de votre organisation
  </Card>
</CardGroup>

<div id="knowledge">
  ## Knowledge
</div>

Gérez Knowledge pour votre organisation :

<CardGroup cols={2}>
  <Card title="Lister les entrées Knowledge" icon="list" href="/fr/api-reference/v1/knowledge/list-knowledge">
    Lister toutes les entrées Knowledge et tous les dossiers de votre organisation
  </Card>

  <Card title="Créer une entrée Knowledge" icon="plus" href="/fr/api-reference/v1/knowledge/create-knowledge">
    Créer une nouvelle entrée Knowledge
  </Card>

  <Card title="Mettre à jour une entrée Knowledge" icon="pencil" href="/fr/api-reference/v1/knowledge/update-knowledge">
    Mettre à jour une entrée Knowledge
  </Card>

  <Card title="Supprimer une entrée Knowledge" icon="trash" href="/fr/api-reference/v1/knowledge/delete-knowledge">
    Supprimer une entrée Knowledge
  </Card>
</CardGroup>

<div id="playbooks">
  ## Playbooks
</div>

Gérez des ensembles d'instructions réutilisables pour votre organisation :

<CardGroup cols={2}>
  <Card title="Lister les playbooks" icon="list" href="/fr/api-reference/v1/playbooks/list-playbooks">
    Afficher tous les playbooks accessibles à votre organisation
  </Card>

  <Card title="Créer un playbook" icon="plus" href="/fr/api-reference/v1/playbooks/create-playbook">
    Créer un nouveau playbook d'équipe avec des instructions et une macro optionnelle
  </Card>

  <Card title="Consulter un playbook" icon="circle-info" href="/fr/api-reference/v1/playbooks/get-playbook">
    Récupérer les détails d'un playbook spécifique
  </Card>

  <Card title="Mettre à jour un playbook" icon="pencil" href="/fr/api-reference/v1/playbooks/update-playbook">
    Mettre à jour un playbook d'équipe existant
  </Card>

  <Card title="Supprimer un playbook" icon="trash" href="/fr/api-reference/v1/playbooks/delete-playbook">
    Supprimer un playbook d'équipe de votre organisation
  </Card>
</CardGroup>

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

Migrez vers l'[API actuelle](/fr/api-reference/overview) pour bénéficier du RBAC (contrôle d’accès basé sur les rôles), de l’attribution des sessions et des nouvelles fonctionnalités. Consultez le [guide de migration](/fr/api-reference/getting-started/migration-guide).