Passer au contenu principal
POST
Créer une nouvelle session
Avec les rôles par défaut Member et Administrateur, toutes les clés d’API peuvent appeler cet endpoint. Sur Enterprise, tout rôle personnalisé ou modifié doit inclure l’autorisation Use Devin Sessions (UseDevinSessions). La session est créée au nom de l’utilisateur auquel appartient la clé d’API.

Limites et validation

  • prompt doit comporter 30,000 caractères au maximum ; au-delà, la requête renvoie une erreur 400.
  • tags accepte au maximum 50 balises, chacune étant une chaîne de caractères non vide de 256 caractères au plus. Les Enterprise qui imposent des balises obligatoires rejettent les noms de balises réservés avec une erreur 400.
  • structured_output_schema doit être un JSON Schema valide (Draft 7) avec "type": "object" à la racine, ne contenir aucun $ref externe et ne pas dépasser 64 Ko ; sinon, la requête renvoie une erreur 400.
  • Dans la réponse, is_new_session n’est défini que si la requête utilise idempotency_key (ou le paramètre obsolète idempotent) ; sinon, sa valeur est null.

Autorisations

Authorization
string
header
requis

Clé d’API personnelle (apk_user_*) ou clé d’API de service (apk_*)

Corps

application/json
prompt
string
requis
idempotent
boolean
défaut:false
knowledge_ids
string[] | null

Liste des identifiants de Knowledge à utiliser. Si None, utiliser toutes les Knowledge. Si la liste est vide, ne pas utiliser de Knowledge.

max_acu_limit
integer | null

La limite maximale d’ACU doit être positive

Plage requise: x > 0
playbook_id
string | null
secret_ids
string[] | null

Liste des identifiants de secrets à utiliser. Si None, utiliser tous les secrets. Si la liste est vide, n’utiliser aucun secret.

session_secrets
SessionSecretInput · object[] | null

Liste des secrets propres à cette session. Ces secrets ne sont disponibles que pendant cette session et ne sont pas stockés dans les secrets de l’organisation.

snapshot_id
string | null
structured_output_schema
Structured Output Schema · object | null

Schéma JSON (Draft 7) permettant de valider la sortie structurée. Taille maximale : 64 Ko. Doit être autonome (aucun $ref externe).

tags
string[] | null

Liste des tags à ajouter à la session.

Maximum array length: 50
title
string | null

Titre personnalisé de la session. Si None, un titre sera généré automatiquement.

unlisted
boolean
défaut:false

Réponse

Réponse en cas de succès

Corps de la réponse renvoyé lorsqu’une session est créée avec succès.

session_id
string
requis
url
string
requis
is_new_session
boolean | null