Documentation Index
Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
Use this file to discover all available pages before exploring further.
API con schema per tenant
Non esiste un riferimento API statico per Twenty. Ogni spazio di lavoro ha il proprio schema — quando aggiungi un oggetto personalizzato (ad esempioInvoice), ottiene immediatamente endpoint REST e GraphQL identici a quelli degli oggetti integrati come Company o Person. L’API è generata dallo schema, quindi gli endpoint usano direttamente i nomi dei tuoi oggetti e campi — niente ID opachi.
La documentazione delle API specifica del tuo spazio di lavoro è disponibile in Impostazioni → API & Webhooks dopo aver creato una chiave API. Include un playground interattivo in cui puoi eseguire chiamate reali sui tuoi dati.
Due API
API principale —/rest/ e /graphql/
CRUD sui record: Persone, Aziende, Opportunità, i tuoi oggetti personalizzati. Esegui query, filtra, attraversa le relazioni.
API dei metadati — /rest/metadata/ e /metadata/
Gestione dello schema: crea/modifica/elimina oggetti, campi e relazioni. Questo è il modo per modificare in modo programmatico il tuo modello di dati.
Entrambe sono disponibili in REST e GraphQL. GraphQL aggiunge upsert in batch e la possibilità di attraversare le relazioni in un’unica query. I dati sottostanti sono gli stessi in entrambi i casi.
URL di base
| Ambiente | URL di base |
|---|---|
| Cloud | https://api.twenty.com/ |
| Auto-ospitato | https://{your-domain}/ |
Autenticazione
Operazioni batch
Sia REST che GraphQL supportano il batching fino a 60 record per richiesta — creazione, aggiornamento o eliminazione. GraphQL supporta anche l’upsert in batch (crea o aggiorna in una sola chiamata) usando nomi plurali comeCreateCompanies.
Limiti di frequenza delle API
| Limite | Valore |
|---|---|
| Richieste | 100 al minuto |
| Dimensione batch | 60 record per chiamata |