Skip to main content
GET
GET Sitzung
Die devin_id ist die Sitzungs-ID mit dem Präfix devin- (z. B. devin-abc123).

Berechtigungen

Erfordert einen Service-Benutzer oder ein persönliches Zugriffstoken, das zur Organisation gehört und die betreffende Sitzung anzeigen darf. Der Aufrufer kann eine Sitzung anzeigen, wenn eine der folgenden Bedingungen erfüllt ist:
  • Er hat die Sitzung erstellt.
  • Er verfügt über einen session.view-Grant für die Sitzung.
  • Er besitzt die Berechtigung ViewOrgSessions auf Organisationsebene.
ViewOrgSessions ist nur erforderlich, um Sitzungen zu lesen, die der Service-Benutzer weder selbst erstellt hat noch für die er einen session.view-Grant besitzt.

On-demand-Nutzung

Bei Teams-Tarifen enthält die Antwort das Feld on_demand_usage: die On-demand-Ausgaben (Überschreitung) der Sitzung in USD, ohne untergeordnete Sitzungen. Der Wert ist 0, wenn die Sitzung vollständig durch das Kontingent Ihres Plans abgedeckt war. Bei anderen Plänen sowie bei den Enterprise-Sitzungsendpunkten fehlt das Feld.

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (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

acus_consumed
number
erforderlich
created_at
integer
erforderlich
org_id
string | null
erforderlich

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

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
automation_id
string | null

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

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,
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
child_session_ids
string[] | null
devin_mode
enum<string> | null

Der Devin-Agent-Modus, mit dem die Sitzung erstellt wurde, nach Auflösung der Organisations-/Nutzer-Standardwerte und der Vererbung von der übergeordneten Sitzung. None, wenn die Sitzung eine Agent-Vorschau ausführt, die kein entsprechendes Modusäquivalent hat.

Verfügbare Optionen:
normal,
fast,
fusion,
lite,
ultra,
swe-2-medium,
swe-2-high,
swe-2-max
is_archived
boolean
Standard:false
on_demand_usage
number | null

Nutzungsabhängige Kosten (Ü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/list-Endpunkten befüllt.

origin
enum<string> | null

Die Quelle, aus der die Sitzung erstellt wurde.

Verfügbare Optionen:
webapp,
slack,
teams,
api,
linear,
jira,
automation,
cli,
desktop,
code_scan,
other
parent_session_id
string | null
playbook_id
string | null
security_profile
SessionSecurityProfileResponse · object | null

Die eigene Sicherheitsprofilbindung der Sitzung. Nur bei GET-/List-Endpunkten befüllt.

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“, „user_usage_limit_exceeded“, „total_session_limit_exceeded“, „contract_expired“ 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,
user_usage_limit_exceeded,
total_session_limit_exceeded,
contract_expired,
error
structured_output
Structured Output · object | null

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