Vai al contenuto principale
Questa guida ti accompagna nella configurazione dell’accesso API per team e organizzazioni standard (non Enterprise). Creerai un utente di servizio, otterrai le tue credenziali ed effettuerai la tua prima chiamata API in pochi minuti.
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

  1. Vai su Settings > API di Devin nella tua organizzazione e apri il tab utenti di servizio
  2. Fai clic su Provision utente di servizio
  3. Scegli un nome visualizzato descrittivo (ad es. “CI Pipeline”, “Monitoring Bot”)
  4. 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
  5. 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.
Usa il ruolo Member per la maggior parte dei casi di automazione. Usa Admin solo se la tua integrazione deve gestire le impostazioni dell’organizzazione o altri utenti.

Passaggio 2: Copia la tua API key

  1. Dopo aver effettuato il provisioning dell’utente di servizio, la sua API key viene mostrata in una finestra di dialogo
  2. Copia subito la chiave — inizia con cog_ e non verrà più mostrata
  3. Conservala in modo sicuro come variabile di ambiente:

Passaggio 3: Effettua la tua prima chiamata API

Crea una sessione Devin:
Trova l’ID della tua organizzazione in cima alla pagina Settings → Devin API.
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.
Per un controllo degli accessi basato sui ruoli (RBAC) più granulare, consulta la guida rapida Enterprise.

Prossimi passi