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, ruoli personalizzati o SSO, consulta invece la guida rapida Enterprise.

​
Passaggio 1: Crea un utente di servizio

  1. Vai su Settings > Service users nella tua organizzazione
  2. Fai clic su Create service user
  3. Scegli un nome descrittivo (ad es. “CI Pipeline”, “Monitoring Bot”)
  4. Seleziona un ruolo:
    • Admin — accesso completo per gestire sessioni, Knowledge, playbook, segreti e impostazioni
    • Member — può creare e gestire sessioni Devin, visualizzare le risorse
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: Genera un’API key

  1. Dopo aver creato l’utente di servizio, fai clic su Generate API key
  2. Copia subito la chiave — inizia con cog_ e non verrà più mostrata
  3. Conservala in modo sicuro come variabile di ambiente:
export DEVIN_API_KEY="cog_your_key_here"

​
Passaggio 3: Effettua la prima chiamata API

Crea una sessione Devin: 
curl -X POST "https://api.devin.ai/v3/organizations/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script that prints Hello World"}'
Non è necessario specificare l’ID dell’organizzazione nell’URL. Poiché il tuo utente di servizio è associato a una singola organizzazione, l’API lo risolve automaticamente. Se vuoi, puoi comunque includerlo: /v3/organizations/{org_id}/sessions. Puoi trovare l’ID della tua organizzazione in Settings → Organization details.
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 il permesso ImpersonateOrgSessions). Consulta Session attribution per i dettagli.

​
Passaggio 4: Operazioni comuni

​
Elenca le sessioni

curl "https://api.devin.ai/v3/organizations/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

​
Invia un messaggio a una sessione attiva

export SESSION_ID="your_session_id"

curl -X POST "https://api.devin.ai/v3/organizations/sessions/$SESSION_ID/messages" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Please also add unit tests"}'

​
Gestire Knowledge

# Elenca le voci di Knowledge
curl "https://api.devin.ai/v3/organizations/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Crea una voce di Knowledge
curl -X POST "https://api.devin.ai/v3/organizations/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Coding standards", "trigger_description": "When writing code", "body": "Use TypeScript strict mode..."}'

​
Autorizzazioni per gli utenti di Teams

Le organizzazioni di Teams hanno un modello di autorizzazioni semplice:
RuoloPuò creare sessioniPuò gestire le risorsePuò gestire le impostazioni
MemberSìSì (Knowledge, playbook, secret)No
AdminSìSìSì
Per un controllo degli accessi basato sui ruoli (RBAC) più granulare, consulta la guida rapida Enterprise.

​
Prossimi passi