> ## 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 v1 (Legacy)

> Gestione principale delle sessioni e automazione con accesso con ambito organizzazione

<Warning>
  Questa versione dell'API è deprecata. Usa [API v3](/it/api-reference/v3/overview) con autenticazione utente di servizio. Consulta la [guida alla migrazione](/it/api-reference/getting-started/migration-guide) per istruzioni passo passo.
</Warning>

L'API v1 fornisce funzionalità fondamentali per creare e gestire sessioni di Devin, insieme a risorse di supporto come secret, knowledge e playbook.

**Base URL:** `https://api.devin.ai/v1/*`

**Autenticazione:** API key personali o di servizio ([scopri di più](/it/api-reference/authentication))

<div id="permissions">
  ## Autorizzazioni
</div>

L'API v1 utilizza un'autenticazione con ambito organizzativo. Le API key sono limitate a una specifica coppia `(org_id, user_id)` e forniscono accesso alle risorse all'interno di tale organizzazione. L'API v1 non utilizza l'intero sistema di autorizzazioni RBAC: l'accesso è determinato dall'ambito organizzativo dell'API key.

Per un controllo RBAC più granulare, utilizza invece l'[Organization API](/it/api-reference/v3/overview).

<div id="sessions">
  ## Sessioni
</div>

Gestisci le sessioni di Devin e interagisci con esse:

<CardGroup cols={2}>
  <Card title="Elenco sessioni" icon="list" href="/it/api-reference/v1/sessions/list-sessions">
    Elenca tutte le sessioni di Devin attuali per la tua organizzazione
  </Card>

  <Card title="Crea una sessione" icon="plus" href="/it/api-reference/v1/sessions/create-a-new-devin-session">
    Avvia una nuova sessione di Devin con una descrizione dell'attività e parametri opzionali
  </Card>

  <Card title="Dettagli sessione" icon="circle-info" href="/it/api-reference/v1/sessions/retrieve-details-about-an-existing-session">
    Recupera informazioni sullo stato e sui risultati di una sessione esistente
  </Card>

  <Card title="Invia un messaggio" icon="message" href="/it/api-reference/v1/sessions/send-a-message-to-an-existing-devin-session">
    Interagisci con una sessione attiva inviando messaggi a Devin
  </Card>

  <Card title="Carica file" icon="upload" href="/it/api-reference/v1/attachments/upload-files-for-devin-to-work-with">
    Carica file che Devin può usare durante le sessioni
  </Card>

  <Card title="Aggiorna tag sessione" icon="tags" href="/it/api-reference/v1/sessions/update-session-tags">
    Aggiorna i tag associati a una sessione di Devin
  </Card>
</CardGroup>

<div id="secrets">
  ## Secret
</div>

Gestisci i secret e le credenziali per la tua organizzazione:

<CardGroup cols={2}>
  <Card title="Elenca i secret" icon="key" href="/it/api-reference/v1/secrets/list-secrets">
    Visualizza i metadati di tutti i secret della tua organizzazione
  </Card>

  <Card title="Elimina secret" icon="trash" href="/it/api-reference/v1/secrets/delete-secret">
    Rimuovi in modo permanente un secret dalla tua organizzazione
  </Card>
</CardGroup>

<div id="knowledge">
  ## Knowledge
</div>

Gestisci Knowledge per la tua organizzazione:

<CardGroup cols={2}>
  <Card title="Elenca Knowledge" icon="list" href="/it/api-reference/v1/knowledge/list-knowledge">
    Elenca tutte le voci Knowledge e le cartelle della tua organizzazione
  </Card>

  <Card title="Crea Knowledge" icon="plus" href="/it/api-reference/v1/knowledge/create-knowledge">
    Crea una nuova voce Knowledge
  </Card>

  <Card title="Aggiorna Knowledge" icon="pencil" href="/it/api-reference/v1/knowledge/update-knowledge">
    Aggiorna una voce Knowledge
  </Card>

  <Card title="Elimina Knowledge" icon="trash" href="/it/api-reference/v1/knowledge/delete-knowledge">
    Elimina una voce Knowledge
  </Card>
</CardGroup>

<div id="playbooks">
  ## Playbook
</div>

Gestisci raccolte di istruzioni riutilizzabili per la tua organizzazione:

<CardGroup cols={2}>
  <Card title="Elenca Playbook" icon="list" href="/it/api-reference/v1/playbooks/list-playbooks">
    Visualizza tutti i playbook accessibili alla tua organizzazione
  </Card>

  <Card title="Crea Playbook" icon="plus" href="/it/api-reference/v1/playbooks/create-playbook">
    Crea un nuovo playbook di team con istruzioni e macro opzionale
  </Card>

  <Card title="Ottieni Playbook" icon="circle-info" href="/it/api-reference/v1/playbooks/get-playbook">
    Ottieni i dettagli di un playbook specifico
  </Card>

  <Card title="Aggiorna Playbook" icon="pencil" href="/it/api-reference/v1/playbooks/update-playbook">
    Aggiorna un playbook di team esistente
  </Card>

  <Card title="Elimina Playbook" icon="trash" href="/it/api-reference/v1/playbooks/delete-playbook">
    Elimina un playbook di team dalla tua organizzazione
  </Card>
</CardGroup>

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

Esegui la migrazione all'[API attuale](/it/api-reference/overview) per RBAC, l'attribuzione delle sessioni e le nuove funzionalità. Consulta la [guida alla migrazione](/it/api-reference/getting-started/migration-guide).