Vai al contenuto principale
POST
/
v3
/
organizations
/
{org_id}
/
sessions
/
{devin_id}
/
insights
/
generate
Genera approfondimenti sulla sessione
curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions/{devin_id}/insights/generate \
  --header 'Authorization: Bearer <token>'
{
  "session_id": "<string>",
  "status": "<string>"
}
Il devin_id è l’ID della sessione preceduto dal prefisso devin- (ad es., devin-abc123).

​
Autorizzazione

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

​
Comportamento

  • Se gli insight sono già stati generati (o la generazione è in corso), l’endpoint restituisce { "status": "already_exists" } senza riavviarla.
  • Se non esistono insight (o l’ultimo tentativo non è andato a buon fine), l’endpoint avvia la generazione in background e restituisce { "status": "started" }.
  • Effettua il polling dell’endpoint GET session insights per recuperare i risultati una volta completata la generazione.

Autorizzazioni

​
Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

​
devin_id
string | null
obbligatorio

ID sessione Devin (prefisso: devin-)

Esempio:

"devin-abc123def456"

​
org_id
string | null
obbligatorio

ID org (prefisso: org-)

Esempio:

"org-abc123def456"

Risposta

Risposta riuscita

Risposta all'attivazione della generazione degli approfondimenti sulla sessione.

​
session_id
string
obbligatorio

L'ID della sessione per cui è stata attivata la generazione dell'approfondimento sulla sessione.

​
status
string
obbligatorio

Lo stato della richiesta di generazione.