> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Panoramica API

> Scopri come interagire in modo programmatico con Devin utilizzando le nostre API REST

Le API di Devin consentono di integrare Devin nelle tue applicazioni, automatizzare i flussi di lavoro e creare strumenti potenti. Usa **service users** con controllo degli accessi basato sui ruoli per un accesso alle API sicuro e verificabile.

<div id="getting-started">
  ## Per iniziare
</div>

<CardGroup cols={2}>
  <Card title="Guida rapida per team" icon="rocket" href="/it/api-reference/getting-started/teams-quickstart">
    Per team e organizzazioni standard. Crea un utente di servizio ed effettua la tua prima chiamata all'API in pochi minuti.
  </Card>

  <Card title="Guida rapida Enterprise" icon="building" href="/it/api-reference/getting-started/enterprise-quickstart">
    Per clienti Enterprise con RBAC, supporto multi-organizzazione e autorizzazioni avanzate.
  </Card>
</CardGroup>

<Tip>
  **Quale percorso scegliere?** La maggior parte dei clienti dovrebbe iniziare dalla guida rapida per team. Scegli Enterprise se gestisci più organizzazioni, utilizzi SSO o hai bisogno di ruoli personalizzati e RBAC.
</Tip>

<div id="api-structure">
  ## Struttura delle API
</div>

L'API è organizzata in due ambiti:

<div id="organization-api">
  ### API dell'organizzazione
</div>

**Base URL:** `https://api.devin.ai/v3/organizations/*`

Per gestire le risorse all'interno di una singola organizzazione — sessioni, Knowledge, playbook, segreti e altro. Qui ha inizio la maggior parte delle integrazioni.

<div id="enterprise-api">
  ### API Enterprise
</div>

**Base URL:** `https://api.devin.ai/v3/enterprise/*`

Per la gestione tra più organizzazioni — analisi, log di audit, gestione degli utenti, fatturazione e infrastruttura. Disponibile per i clienti Enterprise.

Entrambi gli scope utilizzano credenziali di utente di servizio (prefisso `cog_`). Consultare [Autenticazione](/it/api-reference/authentication) per la configurazione.

<div id="session-attribution">
  ## Attribuzione delle sessioni
</div>

Gli utenti di servizio sono identità distinte dagli utenti umani, ma puoi **creare sessioni per conto di qualsiasi utente** all'interno della tua organizzazione usando il parametro `create_as_user_id`. In questo modo le sessioni compaiono nell'elenco delle sessioni di quell'utente e vengono conteggiate nel suo utilizzo — proprio come se le avesse create personalmente.

```bash theme={null}
curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Fix the login bug in issue #42",
    "create_as_user_id": "user_abc123"
  }'
```

<Tip>
  **Stai passando dalle API key personali?** Nelle v1/v2, le API key personali creavano automaticamente le sessioni come il tuo utente. Con la v3, usa un service user + `create_as_user_id` per ottenere lo stesso comportamento, con il vantaggio aggiuntivo di RBAC, audit trail e gestione centralizzata delle chiavi. Il ruolo del service user deve includere il permesso `ImpersonateOrgSessions`.
</Tip>

<Note>
  **Personal Access Tokens (PATs) in arrivo.** I PAT ti permetteranno di autenticarti direttamente come il tuo utente con la v3 API, senza bisogno di un service user o di `create_as_user_id`. Le sessioni verranno automaticamente attribuite a te. Resta in attesa per la disponibilità.
</Note>

Puoi trovare gli ID utente tramite l'endpoint [List users](/it/api-reference/v3/users/organizations-members-users) o nella UI di Devin nelle impostazioni dei membri dell'organizzazione.

<div id="legacy-apis-v1-and-v2">
  ## API legacy (v1 e v2)
</div>

Le API v1 e v2 continueranno a funzionare durante il periodo di deprecazione, ma non riceveranno nuove funzionalità. Consigliamo di migrare all'API attuale per il controllo degli accessi basato sui ruoli, l'attribuzione delle sessioni e le nuove funzionalità.

* [Documentazione API v1](/it/api-reference/v1/overview) — gestione delle sessioni con API key legacy
* [Documentazione API v2](/it/api-reference/v2/overview) — gestione Enterprise con API key legacy
* [Guida alla migrazione](/it/api-reference/getting-started/migration-guide) — migrazione passo dopo passo da v1/v2

***

<div id="error-handling">
  ## Gestione degli errori
</div>

Tutte le API utilizzano i codici di stato HTTP standard:

* `200 OK`: Richiesta completata con successo
* `201 Created`: Risorsa creata correttamente
* `400 Bad Request`: Parametri della richiesta non validi
* `401 Unauthorized`: Chiave API mancante o non valida
* `403 Forbidden`: Autorizzazioni insufficienti
* `404 Not Found`: Risorsa non trovata
* `429 Too Many Requests`: Limite di richieste superato
* `500 Internal Server Error`: Errore del server

<div id="support">
  ## Supporto
</div>

Per domande sull'API o per segnalare problemi, scrivi a [support@cognition.ai](mailto:support@cognition.ai).