Zum Hauptinhalt springen
POST
Sitzung archivieren
Die devin_id ist die Session-ID mit dem Präfix devin- (z. B. devin-abc123).

Berechtigungen

Erfordert einen Service-Benutzer oder ein persönliches Zugriffstoken mit der Berechtigung ManageOrgSessions auf Organisationsebene.

Hinweise

Beim Archivieren werden die Sitzung und ihre untergeordneten Sitzungen als archiviert markiert (is_archived: true), und alle laufenden Sitzungen werden in den Ruhezustand versetzt. Um archivierte Sitzungen zu finden, filtern Sie den Endpunkt zum Auflisten von Sitzungen nach is_archived. Durch das Archivieren wird die Sitzung weder gelöscht noch schreibgeschützt, und es werden auch keine zusätzlichen Daten gesichert:
  • Archivierte Sitzungen lassen sich weiterhin anzeigen, und ihre Tags können weiterhin bearbeitet werden.
  • Wenn Sie eine Nachricht an eine archivierte Sitzung im Ruhezustand senden, wird diese wiederaufgenommen. Beendete Sitzungen können nicht wiederaufgenommen werden – unabhängig davon, ob sie archiviert sind oder nicht.
  • Um die Archivierung rückgängig zu machen, rufen Sie POST /v3/organizations/{org_id}/sessions/{devin_id}/unarchive auf. Das Aufheben der Archivierung gilt nur für die angeforderte Sitzung, nicht für ihre untergeordneten Sitzungen.

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"

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.