Cosa cambia
Passaggio 1: Crea un utente di servizio
Sostituisci la tua chiave API legacy con un utente di servizio:- Vai a Settings > API di Devin e apri la tab utente di servizio
- Clicca su Provision service user, assegna un ruolo appropriato e scegli una scadenza (30 giorni per impostazione predefinita)
- Copia la API key mostrata dopo il provisioning (inizia con
cog_) - Aggiorna l’integrazione per usare la nuova API key
Le tue chiavi API legacy continueranno a funzionare durante il periodo di dismissione. Puoi eseguire la migrazione gradualmente.
Passaggio 2: Aggiornare gli URL degli endpoint
Endpoint delle sessioni
Endpoint di Knowledge
Endpoint dei playbook
Gli endpoint
/playbooks sono deprecati in tutte le versioni dell’API. I playbook stanno migrando verso le Competenze. Crea le nuove istruzioni come skill nella pagina Personalizza. Gli account creati a partire dal 24 ottobre 2026 e privi di playbook ricevono il codice 410 da questi endpoint. Consulta I playbook stanno migrando verso le Competenze.Endpoint dei secret
Endpoint disponibili solo per Enterprise (nuovi)
Questi endpoint non hanno un equivalente v1/v2 — sono disponibili solo nell’API attuale:GET /v3/enterprise/organizations— Elenca le organizzazioniGET /v3/enterprise/audit-logs— Log di auditGET /v3/enterprise/consumption/*— Dati di utilizzo e fatturazioneGET /v3/enterprise/metrics/*— Metriche di utilizzoGET /v3/enterprise/members/users— Gestione utentiGET /v3/enterprise/roles— Gestione dei ruoli- Provisioning degli utenti di servizio, elenchi di accesso IP, limiti di ACU e altro
Passaggio 3: Aggiorna la paginazione
L’API attuale usa una paginazione basata su cursore anziché su offset:Passaggio 4: Gestire le modifiche del formato della risposta
Valori dello stato della sessione
L’API attuale restituisce informazioni di stato più dettagliate. Consulta la documentazione dell’endpoint per lo schema completo.Risposte di errore
L’API attuale restituisce gli errori nel formato RFC 9457, con content typeapplication/problem+json. Il corpo contiene i membri type, title e status e può includere anche i membri detail, instance, errors ed error_code.
Le API legacy restituiscono un corpo JSON con un membro detail. Nelle risposte 422 dell’API attuale, detail è una stringa, mentre il membro errors contiene gli errori a livello di campo.
Tempistiche di dismissione
Settings > API di Devin elenca le chiavi API legacy nella scheda API keys (legacy). Enterprise settings > API di Devin le elenca nella scheda API legacy, dove è visibile un banner che ne segnala la dismissione. Durante il periodo di transizione:- Ora: Le chiavi API legacy continuano a funzionare. Le nuove organizzazioni potrebbero non avere accesso alla creazione di chiavi API legacy.
- Periodo di dismissione: Sia le chiavi API legacy che i token degli utenti di servizio funzionano in parallelo.
- Fine del ciclo di vita: Le chiavi API legacy verranno rimosse a breve. Controlla regolarmente le impostazioni di Devin per eventuali annunci.

