Passer au contenu principal
POST
/
v1
/
sessions
Créer une nouvelle session
curl --request POST \
  --url https://api.devin.ai/v1/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "idempotent": false,
  "knowledge_ids": [
    "<string>"
  ],
  "max_acu_limit": 1,
  "playbook_id": "<string>",
  "secret_ids": [
    "<string>"
  ],
  "session_secrets": [
    {
      "key": "<string>",
      "value": "<string>",
      "sensitive": true
    }
  ],
  "snapshot_id": "<string>",
  "tags": [
    "<string>"
  ],
  "title": "<string>",
  "unlisted": false
}
'
{
  "session_id": "<string>",
  "url": "<string>",
  "is_new_session": true
}

Autorisations

Authorization
string
header
requis

API key personnelle (apk_user_) ou API key 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
tags
string[] | null

Liste des tags à ajouter à la session.

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