Zum Hauptinhalt springen
POST
/
v1
/
sessions
Neue Sitzung erstellen
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
}

Autorisierungen

Authorization
string
header
erforderlich

Persönlicher API Key (apk_user_) oder Service API Key (apk_)

Body

application/json
prompt
string
erforderlich
idempotent
boolean
Standard:false
knowledge_ids
string[] | null

Liste der zu verwendenden Knowledge-IDs. Wenn None, wird die gesamte Knowledge verwendet. Wenn die Liste leer ist, wird keine Knowledge verwendet.

max_acu_limit
integer | null

Maximaler ACU-Grenzwert, muss positiv sein

Erforderlicher Bereich: x > 0
playbook_id
string | null
secret_ids
string[] | null

Liste der zu verwendenden Secret-IDs. Ist der Wert None, werden alle Secrets verwendet. Ist die Liste leer, werden keine Secrets verwendet.

session_secrets
SessionSecretInput · object[] | null

Liste der sitzungsspezifischen Secrets, die verwendet werden sollen. Diese Secrets sind nur in dieser Sitzung verfügbar und werden nicht in den Organisations-Secrets gespeichert.

snapshot_id
string | null
tags
string[] | null

Liste der Tags, die der Sitzung hinzugefügt werden sollen.

title
string | null

Benutzerdefinierter Titel für die Sitzung. Wenn None angegeben ist, wird der Titel automatisch generiert.

unlisted
boolean
Standard:false

Antwort

Erfolgreiche Antwort

Antworttext, der bei erfolgreicher Erstellung einer Sitzung zurückgegeben wird.

session_id
string
erforderlich
url
string
erforderlich
is_new_session
boolean | null