Zum Hauptinhalt springen
DELETE
Sitzung beenden
Die devin_id ist die Sitzungs-ID, der das Präfix devin- vorangestellt ist (z. B. devin-abc123).

Berechtigungen

Erfordert einen Service-Benutzer oder ein persönliches Zugriffstoken, der bzw. das zur Organisation gehört und die betreffende Sitzung verwalten darf. Der Aufrufer darf eine Sitzung verwalten, wenn mindestens eine der folgenden Bedingungen erfüllt ist:
  • Er hat die Sitzung erstellt.
  • Er besitzt einen session.configure-Grant für die Sitzung.
  • Er verfügt auf Organisationsebene über die Berechtigung ManageOrgSessions.
ManageOrgSessions wird nur benötigt, um Sitzungen zu beenden, die der Service-Benutzer weder selbst erstellt hat noch für die er einen session.configure-Grant besitzt.

Hinweise

Eine beendete Sitzung kann nicht wiederaufgenommen werden. Beendete Sitzungen bleiben zum Nachschlagen verfügbar – unabhängig davon, ob Sie sie archivieren oder nicht. Setzen Sie den Parameter archive auf true, um die Sitzung und ihre untergeordneten Sitzungen zusätzlich zu archivieren. Dabei werden sie als archiviert markiert (is_archived: true), und alle noch laufenden untergeordneten Sitzungen werden in den Ruhezustand versetzt. Zusätzliche Daten werden dabei nicht gesichert. Weitere Informationen finden Sie unter Archive Session.

Autorisierungen

Authorization
string
header
erforderlich

Anmeldedaten für Service-Benutzer (Präfix: cog_)

Pfadparameter

org_id
string | null
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

devin_id
string | null
erforderlich

Devin-Sitzungs-ID (Präfix: devin-)

Beispiel:

"devin-abc123def456"

Abfrageparameter

archive
boolean
Standard:false

Ob die Devin-Sitzung archiviert werden soll

Antwort

Erfolgreiche Antwort

session_id
string
erforderlich
url
string
erforderlich
status
enum<string>
erforderlich
Verfügbare Optionen:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
erforderlich
org_id
string | null
erforderlich

Organisation, der die Sitzung gehört. Null bei losgelösten Sitzungen, die dem Konto ihres Erstellers statt einer Organisation gehören.

created_at
integer
erforderlich
updated_at
integer
erforderlich
acus_consumed
number
erforderlich
pull_requests
SessionPullRequest · object[]
erforderlich
title
string | null
playbook_id
string | null
user_id
string | null
is_archived
boolean
Standard:false
parent_session_id
string | null
child_session_ids
string[] | null
service_user_id
string | null
category
enum<string> | null

Die der Sitzung zugewiesene Use-Case-Kategorie, sofern die Kategorisierung ausgeführt wurde. Nur in GET-/List-Endpunkten ausgefüllt.

Verfügbare Optionen:
bug_fixing,
ci_cd_and_devops,
code_quality_and_security,
code_review,
code_review_and_analysis,
data_and_automation,
documentation_and_content,
feature_development,
migrations_and_upgrades,
other,
production_investigation,
refactoring_and_optimization,
research_and_exploration,
security,
unit_test_generation
subcategory
string | null

Der Anzeigename der der Sitzung zugewiesenen Unterkategorie. 'Other', wenn eine Kategorie festgelegt ist, aber keine Unterkategorie zugewiesen oder ermittelt wurde. Nur in GET-/List-Endpunkten ausgefüllt.

origin
enum<string> | null

Der Ursprung, aus dem die Sitzung erstellt wurde.

Verfügbare Optionen:
webapp,
slack,
teams,
api,
linear,
jira,
automation,
cli,
desktop,
code_scan,
other
automation_id
string | null

ID der Automatisierung, die diese Sitzung erstellt hat, falls zutreffend.

structured_output
Structured Output · object | null

Validierte strukturierte Ausgabe aus der Sitzung. Nur in GET-/List-Endpunkten ausgefüllt.

devin_mode
enum<string> | null

Der Devin-Agent-Modus, mit dem die Sitzung erstellt wurde, nachdem die Standardwerte der Organisation/des Nutzers und die Vererbung der übergeordneten Sitzung aufgelöst wurden. None, wenn die Sitzung eine Agent-Vorschau ausführt, die kein entsprechendes Äquivalent für den Modus hat.

Verfügbare Optionen:
normal,
fast,
fusion,
lite,
ultra,
fast-ultra,
swe-2-medium,
swe-2-high,
swe-2-max
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 Nutzereingabe), 'waiting_for_approval' (wartet im sicheren Modus auf die Genehmigung einer Aktion) oder 'finished' (Aufgabe abgeschlossen). Wenn der Status 'suspended' ist: der Grund für die Aussetzung, zum Beispiel 'inactivity', 'user_request', 'usage_limit_exceeded', 'out_of_credits', 'out_of_quota', 'no_quota_allocation', 'payment_declined', 'org_usage_limit_exceeded', 'user_usage_limit_exceeded', 'total_session_limit_exceeded', 'contract_expired' oder 'error'. Nur in GET-/List-Endpunkten ausgefü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,
user_usage_limit_exceeded,
total_session_limit_exceeded,
contract_expired,
error
on_demand_usage
number | null

Nutzungsabhängige Kosten im Überschreitungsstatus in USD für diese Sitzung, ohne untergeordnete Sitzungen. Nur bei Teams-Tarifen befüllt; 0, wenn die Sitzung vollständig durch das Kontingent abgedeckt war. Bei anderen Tarifen nicht enthalten. Nur bei get- und Listenendpunkten befüllt.

security_profile
SessionSecurityProfileResponse · object | null

Die eigene Sicherheitsprofilbindung der Sitzung. Nur in GET-/List-Endpunkten ausgefüllt.