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

# Guida rapida: Enterprise

> Inizia a usare Devin API come utente Enterprise, con RBAC e supporto multi-organizzazione

Questa guida illustra come configurare l'accesso all'API per **organizzazioni Enterprise** con ruoli personalizzati, RBAC e supporto multi-organizzazione.

<Note>
  Se sei su un piano Teams con una singola organizzazione e non hai bisogno di ruoli personalizzati, la [guida rapida per Teams](/it/api-reference/getting-started/teams-quickstart) è più semplice.
</Note>

<Note>
  Se sei un cliente **Devin Enterprise** con una distribuzione dedicata, dovrai sostituire `api.devin.ai` in tutti gli URL API con il dominio API personalizzato della tua organizzazione (ad esempio `api.your-company.devinenterprise.com`). Contatta l'amministratore Devin della tua organizzazione o il supporto di Cognition se non sei sicuro del tuo dominio API.
</Note>

<h2 id="understanding-service-user-scopes">
  Comprendere gli ambiti degli utenti di servizio
</h2>

I clienti Enterprise possono creare utenti di servizio su due livelli:

| Ambito | Base URL | Caso d'uso |
| - | - | - |
| **Enterprise** | `/v3/enterprise/*` | Gestione multi‑organizzazione, analisi, log di audit, gestione dei membri |
| **Organization** | `/v3/organizations/{org_id}/*` | Sessioni, Knowledge, playbook, segreti all'interno di una singola organizzazione |

Un utente di servizio Enterprise con autorizzazioni a livello Enterprise eredita automaticamente le corrispondenti autorizzazioni a livello di organizzazione in **tutte** le organizzazioni.

<h2 id="step-1-create-a-service-user">
  Passaggio 1: Crea un account di servizio
</h2>

<h3 id="enterprise-service-user-cross-org-access">
  Utente di servizio Enterprise (accesso multi-organizzazione)
</h3>

1. Vai su **Enterprise settings > Devin API** e apri la tab **Utenti di servizio**
2. Fai clic su **Provision > Utente di servizio Enterprise**
3. Scegli un nome visualizzato (ad es. "Analytics Dashboard", "Org Provisioning Bot")
4. Assegna un ruolo Enterprise con le autorizzazioni richieste dalla tua integrazione e scegli una scadenza

<h3 id="organization-service-user-single-org-access">
  Utente di servizio dell'organizzazione (accesso a una singola organizzazione)
</h3>

1. Vai a **Settings > Devin API** all'interno dell'organizzazione di destinazione e apri la scheda **Utenti di servizio**
2. Fai clic su **Provision utente di servizio**
3. Scegli un nome visualizzato, assegna un ruolo a livello di organizzazione e scegli una scadenza

Puoi anche effettuare il provisioning di un utente di servizio dell'organizzazione da **Enterprise settings > Devin API** facendo clic su **Provision > Utente di servizio dell'organizzazione** e selezionando l'organizzazione di destinazione.

<Tip>
  Segui il **principio del minimo privilegio**: crea utenti di servizio con ambito di organizzazione quando la tua integrazione ha bisogno di accedere a una sola organizzazione. Usa utenti di servizio Enterprise solo per flussi di lavoro tra più organizzazioni.
</Tip>

<h2 id="step-2-copy-your-api-key">
  Passaggio 2: Copia la tua API key
</h2>

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 d'ambiente:

```bash theme={null}
export DEVIN_API_KEY="cog_your_key_here"
```

<h2 id="step-3-make-your-first-api-call">
  Passaggio 3: Esegui la tua prima chiamata API
</h2>

<h3 id="enterprise-endpoint-example">
  Esempio di endpoint Enterprise
</h3>

Elenca tutte le organizzazioni del tuo account Enterprise:

```bash theme={null}
curl "https://api.devin.ai/v3/enterprise/organizations" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<h3 id="organization-endpoint-example">
  Esempio di endpoint di organizzazione
</h3>

Crea una sessione di Devin in una specifica organizzazione:

```bash theme={null}
export DEVIN_ORG_ID="your_org_id"

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": "Implement the feature described in JIRA-123"}'
```

<h2 id="permissions-and-rbac">
  Autorizzazioni e RBAC
</h2>

Ogni endpoint API, ad eccezione di [`GET /v3/self`](/it/api-reference/v3/self/self), è protetto da una specifica autorizzazione. L'autorizzazione richiesta è documentata nella pagina di riferimento API di ciascun endpoint. Le autorizzazioni sono suddivise in due ambiti:

* **Autorizzazioni Enterprise** — controllano gli endpoint `/v3/enterprise/*` (ad es. `ManageOrganizations`, `ManageBilling`, `ViewAccountMetrics`)
* **Autorizzazioni dell'organizzazione** — controllano gli endpoint `/v3/organizations/{org_id}/*` (ad es. `UseDevinSessions`, `ManageOrgSecrets`, `ManageOrgPlaybooks`)

Un utente di servizio Enterprise con un'autorizzazione a livello Enterprise eredita automaticamente la corrispondente autorizzazione a livello di organizzazione in tutte le organizzazioni. Ad esempio, `ViewAccountSessions` concede `ViewOrgSessions` in ogni organizzazione.

Per la documentazione completa sulle autorizzazioni, consulta la [documentazione sulle autorizzazioni e RBAC](/it/api-reference/v3/overview#enterprise-permissions).

<h2 id="common-enterprise-workflows">
  Flussi di lavoro Enterprise più comuni
</h2>

<h3 id="monitor-consumption-across-orgs">
  Monitorare il consumo nelle varie organizzazioni
</h3>

```bash theme={null}
# Ottieni il riepilogo giornaliero dei consumi (usa timestamp Unix — esempio: 1 gen - 31 gen 2025)
curl "https://api.devin.ai/v3/enterprise/consumption/daily?time_after=1735689600&time_before=1738368000" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<h3 id="audit-log-retrieval">
  Recupero dei log di audit
</h3>

```bash theme={null}
curl "https://api.devin.ai/v3/enterprise/audit-logs" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<h3 id="manage-users-across-organizations">
  Gestisci gli utenti tra più organizzazioni
</h3>

```bash theme={null}
# Elenca gli utenti Enterprise
curl "https://api.devin.ai/v3/enterprise/members/users" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Elenca gli utenti in un'organizzazione specifica
curl "https://api.devin.ai/v3/enterprise/organizations/$DEVIN_ORG_ID/members/users" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<h2 id="next-steps">
  Prossimi passi
</h2>

* Esplora la documentazione completa sulle [autorizzazioni API](/it/api-reference/v3/overview)
* Approfondisci l'[autenticazione](/it/api-reference/authentication)
* Configura la [paginazione](/it/api-reference/concepts/pagination) per insiemi di risultati di grandi dimensioni
* Consulta la [guida alla migrazione](/it/api-reference/getting-started/migration-guide) se stai eseguendo la migrazione da v1/v2


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