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

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

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

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.

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

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

1. Vai su **Enterprise settings > Service users**
2. Fai clic su **Create service user**
3. Scegli un nome (ad es. "Analytics Dashboard", "Org Provisioning Bot")
4. Assegna un ruolo Enterprise con le autorizzazioni richieste dalla tua integrazione

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

1. Vai a **Settings > Service users** all'interno dell'organizzazione di destinazione
2. Fai clic su **Create service user**
3. Scegli un nome e assegna un ruolo a livello di organizzazione

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

<div id="step-2-generate-an-api-key">
  ## Passaggio 2: Genera un'API key
</div>

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

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

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

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

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

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

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"}'
```

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

Ogni endpoint API è 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).

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

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

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

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

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

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

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

<div id="next-steps">
  ## Prossimi passi
</div>

* 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