Vai al contenuto principale
POST
Crea una nuova sessione
Con i ruoli predefiniti Membro e Amministratore, qualsiasi chiave API può chiamare questo endpoint. Nel piano Enterprise, un ruolo personalizzato o modificato deve includere l’autorizzazione Use Devin Sessions (UseDevinSessions). La sessione viene creata per conto dell’utente a cui appartiene la chiave API.

Limiti e convalida

  • prompt deve contenere al massimo 30,000 caratteri; per i prompt più lunghi viene restituito 400.
  • tags accetta al massimo 50 tag, ciascuno costituito da una stringa non vuota di massimo 256 caratteri. Le aziende che impongono tag obbligatori rifiutano i nomi di tag riservati con 400.
  • structured_output_schema deve essere un JSON Schema valido (Draft 7) con "type": "object" alla root, non deve contenere $ref esterni e non deve superare i 64 KB; in caso contrario, la richiesta restituisce 400.
  • is_new_session nella risposta viene valorizzato solo quando la richiesta usa idempotency_key (o il deprecato idempotent); altrimenti è null.

Autorizzazioni

Authorization
string
header
obbligatorio

Chiave API personale (apk_user_*) o chiave API di servizio (apk_*)

Corpo

application/json
prompt
string
obbligatorio
idempotent
boolean
predefinito:false
knowledge_ids
string[] | null

Elenco degli ID di Knowledge da utilizzare. Se è None, utilizza tutta la Knowledge. Se è una lista vuota, non utilizzare alcuna Knowledge.

max_acu_limit
integer | null

Limite massimo di ACU, deve essere positivo

Intervallo richiesto: x > 0
playbook_id
string | null
secret_ids
string[] | null

Elenco di ID di secret da utilizzare. Se è None, vengono usati tutti i secret. Se è una lista vuota, non viene usato alcun secret.

session_secrets
SessionSecretInput · object[] | null

Elenco di segreti specifici della sessione da utilizzare. Questi segreti sono disponibili solo in questa sessione e non vengono archiviati tra i segreti dell’organizzazione.

snapshot_id
string | null
structured_output_schema
Structured Output Schema · object | null

Schema JSON (Draft 7) per convalidare l’output strutturato. Dimensione massima 64 KB. Deve essere autosufficiente (nessun $ref esterno).

tags
string[] | null

Elenco di tag da aggiungere alla sessione.

Maximum array length: 50
title
string | null

Titolo personalizzato per la sessione. Se è None, il titolo verrà generato automaticamente.

unlisted
boolean
predefinito:false

Risposta

Risposta corretta

Corpo della risposta restituito quando una sessione è stata creata correttamente.

session_id
string
obbligatorio
url
string
obbligatorio
is_new_session
boolean | null