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

> Inizia a usare la Devin API come utente di un team o di un'organizzazione standard

Questa guida ti accompagna nella configurazione dell'accesso API per **team e organizzazioni standard** (non Enterprise). Creerai un utente di servizio, otterrai le tue credenziali ed effettuerai la tua prima chiamata API in pochi minuti.

<Note>
  Se fai parte di un account Enterprise con più organizzazioni, ruoli personalizzati o SSO, consulta invece la [guida rapida Enterprise](/it/api-reference/getting-started/enterprise-quickstart).
</Note>

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

1. Vai su **Settings > Service users** nella tua organizzazione
2. Fai clic su **Create service user**
3. Scegli un nome descrittivo (ad es. "CI Pipeline", "Monitoring Bot")
4. Seleziona un ruolo:
   * **Admin** — accesso completo per gestire sessioni, Knowledge, playbook, segreti e impostazioni
   * **Member** — può creare e gestire sessioni Devin, visualizzare le risorse

<Tip>
  Usa il ruolo **Member** per la maggior parte dei casi di automazione. Usa **Admin** solo se la tua integrazione deve gestire le impostazioni dell'organizzazione o altri utenti.
</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 di ambiente:

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

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

Crea una sessione Devin:

```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": "Create a simple Python script that prints Hello World"}'
```

<Tip>
  Trova l'ID della tua organizzazione nella pagina **Settings → Service Users**.
</Tip>

<Note>
  **Vuoi che le sessioni siano attribuite al tuo utente?** Per impostazione predefinita, le sessioni sono attribuite all'utente di servizio. Per creare sessioni per conto di uno specifico utente (in modo che compaiano nell'elenco delle sessioni di quell'utente), aggiungi `"create_as_user_id": "user_abc123"` al corpo della richiesta. Questo richiede il ruolo **Admin** (che include l'autorizzazione `ImpersonateOrgSessions`). Consulta [Session attribution](/it/api-reference/overview#session-attribution) per i dettagli.
</Note>

<div id="step-4-common-operations">
  ## Passaggio 4: Operazioni comuni
</div>

<div id="list-your-sessions">
  ### Elenca le sessioni
</div>

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

<div id="send-a-message-to-a-running-session">
  ### Invia un messaggio a una sessione attiva
</div>

```bash theme={null}
export SESSION_ID="your_session_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions/$SESSION_ID/messages" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Please also add unit tests"}'
```

<div id="manage-knowledge">
  ### Gestire Knowledge
</div>

```bash theme={null}
# Elenca le voci di Knowledge
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Crea una voce di Knowledge
curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Coding standards", "trigger_description": "When writing code", "body": "Use TypeScript strict mode..."}'
```

<div id="permissions-for-teams-users">
  ## Autorizzazioni per gli utenti di Teams
</div>

Le organizzazioni di Teams hanno un modello di autorizzazioni semplice:

| Ruolo      | Può creare sessioni | Può gestire le risorse           | Può gestire le impostazioni |
| ---------- | ------------------- | -------------------------------- | --------------------------- |
| **Member** | Sì                  | Sì (Knowledge, playbook, secret) | No                          |
| **Admin**  | Sì                  | Sì                               | Sì                          |

Per un controllo degli accessi basato sui ruoli (RBAC) più granulare, consulta la [guida rapida Enterprise](/it/api-reference/getting-started/enterprise-quickstart).

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

* Esplora gli endpoint dell'**Organization API** nella barra laterale
* Consulta i [flussi comuni](/it/api-reference/common-flows) per i pattern di integrazione più comuni
* Approfondisci l'[autenticazione](/it/api-reference/authentication)
* Configura le [sessioni pianificate](/it/api-reference/v3/schedules/organizations-schedules) per le attività ricorrenti