Vai al contenuto principale
DELETE
/
v3
/
organizations
/
{org_id}
/
sessions
/
{devin_id}
Termina la sessione
curl --request DELETE \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions/{devin_id} \
  --header 'Authorization: Bearer <token>'
{
  "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>",
  "playbook_id": "<string>",
  "service_user_id": "<string>",
  "status_detail": "working",
  "structured_output": {},
  "title": "<string>",
  "user_id": "<string>"
}
Il devin_id corrisponde all’ID di sessione con il prefisso devin- (ad esempio devin-abc123).

Autorizzazioni

Richiede un utente di servizio con l’autorizzazione ManageOrgSessions a livello di organizzazione.

Note

Una volta terminata, una sessione non può essere ripresa. Se vuoi conservare la sessione per consultazioni future, imposta il parametro archive su true.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

devin_id
string | null
obbligatorio
org_id
string | null
obbligatorio

Parametri della query

archive
boolean
predefinito:false

Indica se archiviare la sessione Devin

Risposta

Risposta con esito positivo

acus_consumed
number
obbligatorio
created_at
integer
obbligatorio
org_id
string
obbligatorio
pull_requests
SessionPullRequest · object[]
obbligatorio
session_id
string
obbligatorio
status
enum<string>
obbligatorio
Opzioni disponibili:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
obbligatorio
updated_at
integer
obbligatorio
url
string
obbligatorio
child_session_ids
string[] | null
is_advanced
boolean
predefinito:false
is_archived
boolean
predefinito:false
parent_session_id
string | null
playbook_id
string | null
service_user_id
string | null
status_detail
enum<string> | null

Dettagli aggiuntivi sullo stato corrente della sessione. Quando lo stato è "running": "working" (sta lavorando attivamente), "waiting_for_user" (in attesa di input dall’utente), "waiting_for_approval" (in attesa di approvazione di un’azione in modalità sicura) oppure "finished" (attività completata). Quando lo stato è "suspended": il motivo della sospensione, ad esempio "inactivity", "user_request", "usage_limit_exceeded", "out_of_credits", "payment_declined", "org_usage_limit_exceeded" oppure "error". Valorizzato solo negli endpoint GET/list.

Opzioni disponibili:
working,
waiting_for_user,
waiting_for_approval,
finished,
inactivity,
user_request,
usage_limit_exceeded,
out_of_credits,
payment_declined,
org_usage_limit_exceeded,
error
structured_output
Structured Output · object

Output strutturato convalidato dalla sessione. Impostato solo sugli endpoint GET/list.

title
string | null
user_id
string | null