Zum Hauptinhalt springen
POST
/
v3beta1
/
organizations
/
{org_id}
/
sessions
Create Session
curl --request POST \
  --url https://api.devin.ai/v3beta1/organizations/{org_id}/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "advanced_mode": "analyze",
  "bypass_approval": true,
  "child_playbook_id": "<string>",
  "create_as_user_id": "<string>",
  "knowledge_ids": [
    "<string>"
  ],
  "max_acu_limit": 123,
  "playbook_id": "<string>",
  "repos": [
    "<string>"
  ],
  "secret_ids": [
    "<string>"
  ],
  "session_links": [
    "<string>"
  ],
  "tags": [
    "<string>"
  ],
  "title": "<string>"
}
'
{
  "acus_consumed": 123,
  "created_at": 123,
  "org_id": "<string>",
  "pull_requests": [
    {
      "pr_state": "<string>",
      "pr_url": "<string>"
    }
  ],
  "session_id": "<string>",
  "status": "new",
  "tags": [
    "<string>"
  ],
  "updated_at": 123,
  "url": "<string>",
  "child_session_ids": [
    "<string>"
  ],
  "is_advanced": false,
  "is_archived": false,
  "parent_session_id": "<string>",
  "title": "<string>",
  "user_id": "<string>"
}

Berechtigungen

Erfordert einen Servicebenutzer mit der Berechtigung ManageOrgSessions auf Organisationsebene.

Zusätzliche Berechtigungen für erweiterte Funktionen

FunktionErforderliche Berechtigung
advanced_modeUseDevinExpert
create_as_user_idImpersonateOrgSessions

Erweiterter Modus

Der Parameter advanced_mode aktiviert ein spezialisiertes Sitzungsverhalten für Automatisierungs-Workflows. Wenn er gesetzt ist, verwendet die Sitzung die erweiterte Persona und der Prompt wird basierend auf dem ausgewählten Modus angepasst.

Verfügbare Modi

ModusBeschreibungErforderliche Parameter
analyzeVorhandene Devin-Sitzungen analysieren, um Erkenntnisse zu gewinnensession_links
createEin neues Playbook basierend auf der Sitzungsanalyse erstellenKeine (optional: session_links)
improveEin vorhandenes Playbook anhand von Feedback verbessernchild_playbook_id
batchMehrere Devin-Sitzungen für eine Liste von Aufgaben startenchild_playbook_id
manageKnowledge verwaltenKeine

Optionen für den Batch-Modus

Wenn Sie den batch-Modus verwenden, können Sie optional bypass_approval auf true setzen, um den Genehmigungsschritt bei der Erstellung von Sitzungen im Batch-Modus zu überspringen. Dies ist nützlich für vollständig automatisierte Workflows, bei denen Sitzungen sofort ohne manuelle Genehmigung gestartet werden sollen.

Nutzer-Identitätswechsel

Der create_as_user_id-Parameter ermöglicht das Erstellen einer Session im Namen eines anderen Nutzers. Dafür ist Folgendes erforderlich:
  1. Der Dienstbenutzer muss die Berechtigung ImpersonateOrgSessions haben
  2. Der Zielbenutzer muss Mitglied der Organisation sein
  3. Der Zielbenutzer muss die Berechtigung UseDevinSessions haben

Autorisierungen

Authorization
string
header
erforderlich

Service User credential (prefix: cog_)

Body

application/json
prompt
string
erforderlich
advanced_mode
enum<string> | null
Verfügbare Optionen:
analyze,
create,
improve,
batch,
manage
bypass_approval
boolean | null
child_playbook_id
string | null
create_as_user_id
string | null
knowledge_ids
string[] | null
max_acu_limit
integer | null
playbook_id
string | null
repos
string[] | null
secret_ids
string[] | null
tags
string[] | null
title
string | null

Antwort

Successful Response

acus_consumed
number
erforderlich
created_at
integer
erforderlich
org_id
string
erforderlich
pull_requests
SessionPullRequest · object[]
erforderlich
session_id
string
erforderlich
status
enum<string>
erforderlich
Verfügbare Optionen:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
erforderlich
updated_at
integer
erforderlich
url
string
erforderlich
child_session_ids
string[] | null
is_advanced
boolean
Standard:false
is_archived
boolean
Standard:false
parent_session_id
string | null
title
string | null
user_id
string | null