Session erstellen

curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "attachment_urls": [
    "<string>"
  ],
  "bypass_approval": true,
  "child_playbook_id": "<string>",
  "create_as_user_id": "<string>",
  "knowledge_ids": [
    "<string>"
  ],
  "max_acu_limit": 123,
  "platform": "<string>",
  "playbook_id": "<string>",
  "repos": [
    "<string>"
  ],
  "secret_ids": [
    "<string>"
  ],
  "session_links": [
    "<string>"
  ],
  "session_secrets": [
    {
      "key": "<string>",
      "value": "<string>",
      "sensitive": true
    }
  ],
  "structured_output_required": true,
  "structured_output_schema": {},
  "tags": [
    "<string>"
  ],
  "title": "<string>"
}
'

{
  "acus_consumed": 123,
  "created_at": 123,
  "org_id": "<string>",
  "pull_requests": [
    {
      "pr_state": "<string>",
      "pr_url": "<string>"
    }
  ],
  "session_id": "<string>",
  "tags": [
    "<string>"
  ],
  "updated_at": 123,
  "url": "<string>",
  "child_session_ids": [
    "<string>"
  ],
  "is_archived": false,
  "parent_session_id": "<string>",
  "playbook_id": "<string>",
  "service_user_id": "<string>",
  "structured_output": {},
  "subcategory": "<string>",
  "title": "<string>",
  "user_id": "<string>"
}

POST

organizations

{org_id}

sessions

Session erstellen

curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "attachment_urls": [
    "<string>"
  ],
  "bypass_approval": true,
  "child_playbook_id": "<string>",
  "create_as_user_id": "<string>",
  "knowledge_ids": [
    "<string>"
  ],
  "max_acu_limit": 123,
  "platform": "<string>",
  "playbook_id": "<string>",
  "repos": [
    "<string>"
  ],
  "secret_ids": [
    "<string>"
  ],
  "session_links": [
    "<string>"
  ],
  "session_secrets": [
    {
      "key": "<string>",
      "value": "<string>",
      "sensitive": true
    }
  ],
  "structured_output_required": true,
  "structured_output_schema": {},
  "tags": [
    "<string>"
  ],
  "title": "<string>"
}
'

{
  "acus_consumed": 123,
  "created_at": 123,
  "org_id": "<string>",
  "pull_requests": [
    {
      "pr_state": "<string>",
      "pr_url": "<string>"
    }
  ],
  "session_id": "<string>",
  "tags": [
    "<string>"
  ],
  "updated_at": 123,
  "url": "<string>",
  "child_session_ids": [
    "<string>"
  ],
  "is_archived": false,
  "parent_session_id": "<string>",
  "playbook_id": "<string>",
  "service_user_id": "<string>",
  "structured_output": {},
  "subcategory": "<string>",
  "title": "<string>",
  "user_id": "<string>"
}

Berechtigungen

Erfordert einen Servicebenutzer mit der Berechtigung ManageOrgSessions auf Organisationsebene.

Zusätzliche Berechtigungen für erweiterte Funktionen

Funktion	Erforderliche Berechtigung
`create_as_user_id`	`ImpersonateOrgSessions`

Devin-Modus

Der Parameter devin_mode legt fest, welcher Devin-Agent-Modus für die Sitzung verwendet wird:

Modus	Beschreibung
`normal`	Der Standard-Agent-Modus. Schnell und gut für langfristige Planung.
`fast`	~2x schneller, 4x teurer, gleiche Intelligenz.

Wenn der Parameter weggelassen wird, verwendet die Sitzung den Standardmodus der Organisation. Für den schnellen Modus gelten dieselben Einschränkungen hinsichtlich Feature-Flags und der Enterprise-Agent-Preview wie für die Web-App.

Nutzer-Impersonation

Der Parameter create_as_user_id ermöglicht das Erstellen einer Sitzung im Namen eines anderen Nutzers. Dafür ist Folgendes erforderlich:

Der Servicebenutzer muss die Berechtigung ImpersonateOrgSessions haben
Der Zielnutzer muss Mitglied der Organisation sein
Der Zielnutzer muss die Berechtigung UseDevinSessions haben

Autorisierungen

Authorization

string

header

erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Pfadparameter

org_id

string | null

erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Abfrageparameter

devin_id

string | null

Body

application/json

prompt

string

erforderlich

attachment_urls

string<uri>[] | null

Required string length: 1 - 2083

bypass_approval

boolean | null

child_playbook_id

string | null

create_as_user_id

string | null

devin_mode

enum<string> | null

Setze den Devin Agent-Modus für die Sitzung außer Kraft. 'normal' ist der Standard-Agent-Modus (schnell und gut für langfristige Planung). 'fast' ist etwa 2x schneller, 4x teurer, bei gleicher Intelligenz. Für den Fast-Modus gelten dieselben Feature-Flag- und Enterprise-Agent-Preview-Einschränkungen wie für die Web-App.

Verfügbare Optionen:

normal,

fast

knowledge_ids

string[] | null

max_acu_limit

integer | null

platform

string | null

Überschreibt die VM-Plattform für die Sitzung (z. B. 'windows'). Wenn nicht angegeben (oder auf 'inherit' gesetzt), übernimmt eine von einem übergeordneten Devin erstellte Sitzung die Plattform des Elternobjekts; andernfalls wird der Standard der Organisation verwendet. Übergeben Sie 'default', um unabhängig vom Elternobjekt den Standard der Organisation zu erzwingen. Jeder andere Wert muss einer für Ihre Organisation konfigurierten Plattform entsprechen (ohne Berücksichtigung der Groß-/Kleinschreibung); unbekannte Werte werden mit einem 400-Fehler abgelehnt, dessen Fehlertext die verfügbaren Plattform-Labels für die Org auflistet.

playbook_id

string | null

repos

string[] | null

secret_ids

string[] | null

session_links

string[] | null

session_secrets

SessionSecretInput · object[] | null

Show child attributes

structured_output_required

boolean | null

Wenn „true“ (Standard), MUSS der Agent provide_structured_output mit is_final=true aufrufen, bevor sein Turn endet. Wenn „false“, ist das Tool verfügbar, aber nicht erforderlich — es ist nicht garantiert, dass es in einem bestimmten Turn aufgerufen wird.

structured_output_schema

Structured Output Schema · object

JSON-Schema (Draft 7) zur Validierung strukturierter Ausgaben. Max. 64 KB. Muss in sich abgeschlossen sein (keine externen $ref-Verweise).

Antwort

Erfolgreiche Antwort

acus_consumed

number

erforderlich

created_at

integer

erforderlich

org_id

string

erforderlich

pull_requests

SessionPullRequest · object[]

erforderlich

Show child attributes

session_id

string

erforderlich

status

enum<string>

erforderlich

Verfügbare Optionen:

new,

claimed,

running,

exit,

error,

suspended,

resuming

category

enum<string> | null

Die der Sitzung zugewiesene Anwendungsfallkategorie, falls die Kategorisierung ausgeführt wurde. Nur bei GET-/List-Endpunkten befüllt.

Verfügbare Optionen:

bug_fixing,

ci_cd_and_devops,

code_quality_and_security,

code_review_and_analysis,

data_and_automation,

documentation_and_content,

feature_development,

migrations_and_upgrades,

other,

refactoring_and_optimization,

research_and_exploration,

unit_test_generation

child_session_ids

string[] | null

is_archived

boolean

Standard:false

origin

enum<string> | null

Die Quelle, aus der die Sitzung erstellt wurde.

Verfügbare Optionen:

webapp,

slack,

teams,

api,

linear,

jira,

automation,

cli,

desktop,

other

parent_session_id

string | null

playbook_id

string | null

service_user_id

string | null

status_detail

enum<string> | null

Zusätzliche Details zum aktuellen Status der Sitzung. Wenn der Status „running“ ist: „working“ (arbeitet aktiv), „waiting_for_user“ (benötigt Eingaben des Nutzers), „waiting_for_approval“ (wartet im abgesicherten Modus auf die Genehmigung einer Aktion) oder „finished“ (Aufgabe abgeschlossen). Wenn der Status „suspended“ ist: der Grund für die Unterbrechung, z. B. „inactivity“, „user_request“, „usage_limit_exceeded“, „out_of_credits“, „out_of_quota“, „no_quota_allocation“, „payment_declined“, „org_usage_limit_exceeded“, „total_session_limit_exceeded“ oder „error“. Nur bei GET-/List-Endpunkten befüllt.

Verfügbare Optionen:

working,

waiting_for_user,

waiting_for_approval,

finished,

inactivity,

user_request,

usage_limit_exceeded,

out_of_credits,

out_of_quota,

no_quota_allocation,

payment_declined,

org_usage_limit_exceeded,

total_session_limit_exceeded,

error

structured_output

Structured Output · object

Validierte strukturierte Ausgabe aus der Session. Wird nur bei GET-/LIST-Endpunkten befüllt.

subcategory

string | null

Der Anzeigename der der Sitzung zugewiesenen Unterkategorie. „Other“, wenn eine Kategorie festgelegt ist, aber keine Unterkategorie zugewiesen oder bezogen werden konnte. Nur bei GET-/List-Endpunkten befüllt.

title

string | null

user_id

string | null

Sessions auflisten GET Sitzung

⌘I

Documentation Index

​Berechtigungen

​Zusätzliche Berechtigungen für erweiterte Funktionen

​Devin-Modus

​Nutzer-Impersonation

Autorisierungen

Pfadparameter

Abfrageparameter

Body

Antwort

Berechtigungen

Zusätzliche Berechtigungen für erweiterte Funktionen

Devin-Modus

Nutzer-Impersonation