Se fai parte di un account Enterprise con più organizzazioni o ruoli personalizzati, consulta invece la guida rapida Enterprise.
Passaggio 1: Crea un utente di servizio
- Vai su Settings > API di Devin nella tua organizzazione e apri il tab utenti di servizio
- Fai clic su Provision utente di servizio
- Scegli un nome visualizzato descrittivo (ad es. “CI Pipeline”, “Monitoring Bot”)
- Seleziona un ruolo nel menu a discesa Organization role. Il modulo non prevede caselle di controllo per le singole autorizzazioni: un utente di servizio eredita le autorizzazioni dal ruolo selezionato.
- Admin — accesso completo, incluse le impostazioni dell’organizzazione e la gestione dei membri
- Member — può creare e gestire sessioni Devin e la maggior parte delle risorse dell’organizzazione, ma non le impostazioni dell’organizzazione o la gestione dei membri
- Scegli una Expiration. Il valore predefinito è 30 days; le altre opzioni sono 7 giorni, 90 giorni e, se il tuo account lo consente, Never. Dopo la data di scadenza la chiave API dell’utente di servizio smette di funzionare, quindi predisponi un sostituto prima di allora. Una scadenza più breve limita il periodo in cui una chiave compromessa può essere utilizzata.
Passaggio 2: Copia la tua API key
- Dopo aver effettuato il provisioning dell’utente di servizio, la sua API key viene mostrata in una finestra di dialogo
- Copia subito la chiave — inizia con
cog_e non verrà più mostrata - Conservala in modo sicuro come variabile di ambiente:
Passaggio 3: Effettua la tua prima chiamata API
Crea una sessione Devin:Vuoi che le sessioni siano attribuite al tuo utente? Per impostazione predefinita, le sessioni sono attribuite all’utente di servizio. Per creare sessioni per conto di uno specifico utente (in modo che compaiano nell’elenco delle sessioni di quell’utente), aggiungi
"create_as_user_id": "user_abc123" al corpo della richiesta. Questo richiede il ruolo Admin (che include l’autorizzazione ImpersonateOrgSessions). Consulta Session attribution per i dettagli.Passaggio 4: Operazioni comuni
Elenca le sessioni
Invia un messaggio a una sessione attiva
Gestire Knowledge
Autorizzazioni per gli utenti di Team
Le organizzazioni di Team hanno un modello di autorizzazioni semplice:I playbook sono in fase di migrazione verso Skills. In un account Team già migrato, le operazioni di scrittura su
/playbooks vengono applicate alla skill corrispondente al playbook. Un account creato a partire dal 24 ottobre 2026 e privo di playbook riceve un 410 dagli endpoint /playbooks.Prossimi passi
- Esplora gli endpoint dell’Organization API nella barra laterale
- Consulta i flussi comuni per i pattern di integrazione più comuni
- Approfondisci l’autenticazione
- Configura le automazioni pianificate per le attività ricorrenti

