> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/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.

<h2 id="getting-started">
  Per iniziare
</h2>

<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>

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

L'API è organizzata in due ambiti:

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

**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.

<h3 id="enterprise-api">
  API Enterprise
</h3>

**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.

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

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 chiavi API personali?** Nelle v1/v2, le chiavi API personali creavano automaticamente le sessioni come il tuo utente. Con la v3, usa un utente di servizio + `create_as_user_id` per ottenere lo stesso comportamento, con il vantaggio aggiuntivo di RBAC, audit trail e gestione centralizzata delle chiavi. Il ruolo dell'utente di servizio deve includere l'autorizzazione `ImpersonateOrgSessions`.
</Tip>

<Note>
  Puoi anche autenticarti direttamente come il tuo utente con un [Personal Access Token](/it/api-reference/personal-access-tokens), senza bisogno di un utente di servizio o di `create_as_user_id`. Le sessioni vengono automaticamente attribuite a te.
</Note>

Puoi trovare gli ID utente tramite l'endpoint [List organization users](/it/api-reference/v3/users/list-organization-users) (beta, richiede un utente di servizio con ambito di organizzazione) o l'endpoint enterprise [List users](/it/api-reference/v3/users/organizations-members-users). Entrambi restituiscono solo gli utenti con assegnazioni di ruolo dirette. Per gli utenti la cui appartenenza deriva da gruppi IDP, usa [List organization IDP group users](/it/api-reference/v3/users/list-organization-idp-users) o il relativo [equivalente enterprise](/it/api-reference/v3/users/organizations-members-idp-users).

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

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

***

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

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

<h2 id="support">
  Supporto
</h2>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.