# dentalspace

> Documentazione di dentalspace, il gestionale per studi e cliniche dentistiche: guida all'app e riferimento dell'API v1.

> ## Agent Instructions
> Documentazione di dentalspace. Il testo completo, incluso il riferimento API, è in /llms-full.txt. Per endpoint, campi e codici di errore la fonte di verità è openapi.json: non usare endpoint o campi non documentati.

- [dentalspace](https://docs.dentalspace.ai/index.md): Il gestionale per studi e cliniche dentistiche.
- [Aggiungere un paziente](https://docs.dentalspace.ai/guide/nuovo-paziente.md): Creare la scheda di un nuovo paziente.
- [Fissare un appuntamento](https://docs.dentalspace.ai/guide/nuovo-appuntamento.md): Inserire un appuntamento in agenda.
- [Preparare un piano di cura](https://docs.dentalspace.ai/guide/nuovo-piano-cura.md): Creare un piano di trattamento per un paziente.
- [Introduzione all'API](https://docs.dentalspace.ai/api/introduzione.md): API REST v1 di dentalspace: indirizzo, formato di richieste e risposte, versioni, elenco delle risorse.
- [Autenticazione](https://docs.dentalspace.ai/api/autenticazione.md): Chiavi API, header, scope per area, sedi, chiavi di prova, creazione, rigenerazione e revoca.
- [Errori](https://docs.dentalspace.ai/api/errori.md): Formato della risposta di errore, codici HTTP, codici errore e motivi più comuni.
- [Idempotenza](https://docs.dentalspace.ai/api/idempotenza.md): Header Idempotency-Key per ripetere una richiesta senza creare doppioni.
- [Paginazione](https://docs.dentalspace.ai/api/paginazione.md): Elenchi a cursore, sincronizzazione incrementale e risposte che dicono quanto coprono.
- [Limiti di richiesta](https://docs.dentalspace.ai/api/limiti.md): Quante richieste per clinica e per chiave, header X-RateLimit-* e Retry-After, risposta 429.
- [Webhook](https://docs.dentalspace.ai/api/webhook.md): Avvisi a un tuo indirizzo quando succede qualcosa: destinazioni, busta, catalogo degli eventi, firma HMAC, ritentativi, storico.
- [Dati clinici e registro accessi](https://docs.dentalspace.ai/api/dati-clinici.md): Gli scope clinical:*, cosa aprono, perché sono spenti di default e come ogni accesso finisce nel registro della clinica.
- [La chiave che sta chiamando](https://docs.dentalspace.ai/api-reference/meta/la-chiave-che-sta-chiamando.md): Clinica, chiave (scope, sedi, scadenza), limiti e modalita'. Basta una chiave valida, senza scope.
- [Stato del servizio](https://docs.dentalspace.ai/api-reference/meta/stato-del-servizio.md): Non richiede chiave.
- [Specifica OpenAPI 3.1](https://docs.dentalspace.ai/api-reference/meta/specifica-openapi-31.md): Non richiede chiave.
- [Le sedi della clinica](https://docs.dentalspace.ai/api-reference/studio/le-sedi-della-clinica.md): Scope: `clinic:read`.
- [Una sede](https://docs.dentalspace.ai/api-reference/studio/una-sede.md): Scope: `clinic:read`.
- [Le poltrone attive di una sede](https://docs.dentalspace.ai/api-reference/studio/le-poltrone-attive-di-una-sede.md): Scope: `clinic:read`.
- [I medici della clinica](https://docs.dentalspace.ai/api-reference/studio/i-medici-della-clinica.md): Scope: `clinic:read`.
- [I calendari prenotabili](https://docs.dentalspace.ai/api-reference/studio/i-calendari-prenotabili.md): Scope: `clinic:read`.
- [Un calendario](https://docs.dentalspace.ai/api-reference/studio/un-calendario.md): Scope: `clinic:read`.
- [Il listino](https://docs.dentalspace.ai/api-reference/studio/il-listino.md): Scope: `clinic:read`.
- [Una prestazione](https://docs.dentalspace.ai/api-reference/studio/una-prestazione.md): Scope: `clinic:read`.
- [Chi e' questo numero?](https://docs.dentalspace.ai/api-reference/pazienti/chi-e-questo-numero?.md): Scope: `patients:read`.
- [Cerca un paziente](https://docs.dentalspace.ai/api-reference/pazienti/cerca-un-paziente.md): Scope: `patients:read`.
- [Elenco dei pazienti](https://docs.dentalspace.ai/api-reference/pazienti/elenco-dei-pazienti.md): Scope: `patients:read`.
- [Crea un paziente](https://docs.dentalspace.ai/api-reference/pazienti/crea-un-paziente.md): Scope: `patients:write`.
- [La scheda di un paziente](https://docs.dentalspace.ai/api-reference/pazienti/la-scheda-di-un-paziente.md): Scope: `patients:read`.
- [Modifica un paziente](https://docs.dentalspace.ai/api-reference/pazienti/modifica-un-paziente.md): Scope: `patients:write`.
- [Archivia un paziente](https://docs.dentalspace.ai/api-reference/pazienti/archivia-un-paziente.md): Scope: `patients:write`.
- [Riattiva un paziente archiviato](https://docs.dentalspace.ai/api-reference/pazienti/riattiva-un-paziente-archiviato.md): Scope: `patients:write`.
- [Gli appuntamenti di un paziente](https://docs.dentalspace.ai/api-reference/pazienti/gli-appuntamenti-di-un-paziente.md): Scope: `patients:read` e `appointments:read`.
- [I preventivi di un paziente](https://docs.dentalspace.ai/api-reference/pazienti/i-preventivi-di-un-paziente.md): Scope: `patients:read` e `treatment_plans:read`.
- [I dati sanitari di un paziente](https://docs.dentalspace.ai/api-reference/pazienti/i-dati-sanitari-di-un-paziente.md): Scope: `clinical:read`.
- [I documenti di un paziente](https://docs.dentalspace.ai/api-reference/pazienti/i-documenti-di-un-paziente.md): Scope: `documents:read`.
- [Orari liberi di un calendario](https://docs.dentalspace.ai/api-reference/agenda/orari-liberi-di-un-calendario.md): Scope: `appointments:read`.
- [Prenota un orario](https://docs.dentalspace.ai/api-reference/agenda/prenota-un-orario.md): Scope: `appointments:write`.
- [Elenco degli appuntamenti](https://docs.dentalspace.ai/api-reference/agenda/elenco-degli-appuntamenti.md): Scope: `appointments:read`.
- [Crea un appuntamento fuori calendario](https://docs.dentalspace.ai/api-reference/agenda/crea-un-appuntamento-fuori-calendario.md): Scope: `appointments:write`.
- [Un appuntamento](https://docs.dentalspace.ai/api-reference/agenda/un-appuntamento.md): Scope: `appointments:read`.
- [Modifica titolo, motivo o note](https://docs.dentalspace.ai/api-reference/agenda/modifica-titolo-motivo-o-note.md): Scope: `appointments:write`.
- [Sposta un appuntamento](https://docs.dentalspace.ai/api-reference/agenda/sposta-un-appuntamento.md): Scope: `appointments:write`.
- [Disdici un appuntamento](https://docs.dentalspace.ai/api-reference/agenda/disdici-un-appuntamento.md): Scope: `appointments:write`.
- [Conferma la presenza](https://docs.dentalspace.ai/api-reference/agenda/conferma-la-presenza.md): Scope: `appointments:write`.
- [Cambia lo stato](https://docs.dentalspace.ai/api-reference/agenda/cambia-lo-stato.md): Scope: `appointments:write`.
- [Elenco dei preventivi](https://docs.dentalspace.ai/api-reference/preventivi/elenco-dei-preventivi.md): Scope: `treatment_plans:read`.
- [Crea una bozza di preventivo dal listino](https://docs.dentalspace.ai/api-reference/preventivi/crea-una-bozza-di-preventivo-dal-listino.md): Scope: `treatment_plans:write`.
- [Un preventivo, con le voci](https://docs.dentalspace.ai/api-reference/preventivi/un-preventivo-con-le-voci.md): Scope: `treatment_plans:read`.
- [Cambia lo stato di un preventivo](https://docs.dentalspace.ai/api-reference/preventivi/cambia-lo-stato-di-un-preventivo.md): Scope: `treatment_plans:write`.
- [Elenco delle fatture](https://docs.dentalspace.ai/api-reference/fatture-e-pagamenti/elenco-delle-fatture.md): Scope: `billing:read`.
- [Una fattura, con le righe](https://docs.dentalspace.ai/api-reference/fatture-e-pagamenti/una-fattura-con-le-righe.md): Scope: `billing:read`.
- [Gli incassi di una fattura](https://docs.dentalspace.ai/api-reference/fatture-e-pagamenti/gli-incassi-di-una-fattura.md): Scope: `billing:read`.
- [Registra un incasso](https://docs.dentalspace.ai/api-reference/fatture-e-pagamenti/registra-un-incasso.md): Scope: `billing:write`.
- [Piani di pagamento e rate](https://docs.dentalspace.ai/api-reference/fatture-e-pagamenti/piani-di-pagamento-e-rate.md): Scope: `billing:read`.
- [Crea un link di pagamento](https://docs.dentalspace.ai/api-reference/fatture-e-pagamenti/crea-un-link-di-pagamento.md): Scope: `billing:write`.
- [Un documento del paziente](https://docs.dentalspace.ai/api-reference/documenti/un-documento-del-paziente.md): Scope: `documents:read`.
- [Elenco delle attivita'](https://docs.dentalspace.ai/api-reference/attività/elenco-delle-attivita.md): Scope: `tasks:read`.
- [Crea un'attivita'](https://docs.dentalspace.ai/api-reference/attività/crea-unattivita.md): Scope: `tasks:write`.
- [Modifica un'attivita'](https://docs.dentalspace.ai/api-reference/attività/modifica-unattivita.md): Scope: `tasks:write`.
- [Elenco dei lead](https://docs.dentalspace.ai/api-reference/contatti-commerciali/elenco-dei-lead.md): Scope: `leads:read`.
- [Crea un lead](https://docs.dentalspace.ai/api-reference/contatti-commerciali/crea-un-lead.md): Scope: `leads:write`.
- [Un lead](https://docs.dentalspace.ai/api-reference/contatti-commerciali/un-lead.md): Scope: `leads:read`.
- [Modifica un lead](https://docs.dentalspace.ai/api-reference/contatti-commerciali/modifica-un-lead.md): Scope: `leads:write`.
- [Aggiungi un'attivita' a un lead](https://docs.dentalspace.ai/api-reference/contatti-commerciali/aggiungi-unattivita-a-un-lead.md): Scope: `leads:write`.
- [Converti un lead in paziente](https://docs.dentalspace.ai/api-reference/contatti-commerciali/converti-un-lead-in-paziente.md): Scope: `leads:write` e `patients:write`.
- [Elenco delle conversazioni WhatsApp](https://docs.dentalspace.ai/api-reference/messaggi-whatsapp/elenco-delle-conversazioni-whatsapp.md): Scope: `messages:read`.
- [I messaggi di una conversazione](https://docs.dentalspace.ai/api-reference/messaggi-whatsapp/i-messaggi-di-una-conversazione.md): Scope: `messages:read`.
- [Manda un messaggio WhatsApp](https://docs.dentalspace.ai/api-reference/messaggi-whatsapp/manda-un-messaggio-whatsapp.md): Scope: `messages:write`.
- [Stato del bot su una conversazione](https://docs.dentalspace.ai/api-reference/messaggi-whatsapp/stato-del-bot-su-una-conversazione.md): Scope: `messages:write`.
- [Registra una telefonata conclusa](https://docs.dentalspace.ai/api-reference/telefonate/registra-una-telefonata-conclusa.md): Scope: `calls:write`.
- [Elenca le telefonate](https://docs.dentalspace.ai/api-reference/telefonate/elenca-le-telefonate.md): Scope: `calls:read`.
- [Una telefonata](https://docs.dentalspace.ai/api-reference/telefonate/una-telefonata.md): Scope: `calls:read`.
- [Briefing prima della chiamata](https://docs.dentalspace.ai/api-reference/agente-vocale/briefing-prima-della-chiamata.md): Scope: `patients:read` e `appointments:read`.
- [Passa la chiamata alla segreteria](https://docs.dentalspace.ai/api-reference/agente-vocale/passa-la-chiamata-alla-segreteria.md): Scope: `tasks:write`.
- [Elenca gli eventi](https://docs.dentalspace.ai/api-reference/webhook-ed-eventi/elenca-gli-eventi.md): Scope: `webhooks:read`.
- [Elenca le destinazioni dei webhook](https://docs.dentalspace.ai/api-reference/webhook-ed-eventi/elenca-le-destinazioni-dei-webhook.md): Scope: `webhooks:read`.
- [Crea una destinazione dei webhook](https://docs.dentalspace.ai/api-reference/webhook-ed-eventi/crea-una-destinazione-dei-webhook.md): Scope: `webhooks:write`.
- [Una destinazione](https://docs.dentalspace.ai/api-reference/webhook-ed-eventi/una-destinazione.md): Scope: `webhooks:read`.
- [Modifica una destinazione](https://docs.dentalspace.ai/api-reference/webhook-ed-eventi/modifica-una-destinazione.md): Scope: `webhooks:write`.
- [Elimina una destinazione](https://docs.dentalspace.ai/api-reference/webhook-ed-eventi/elimina-una-destinazione.md): Scope: `webhooks:write`.
- [Ruota il segreto di una destinazione](https://docs.dentalspace.ai/api-reference/webhook-ed-eventi/ruota-il-segreto-di-una-destinazione.md): Scope: `webhooks:write`.
- [Manda un webhook di prova](https://docs.dentalspace.ai/api-reference/webhook-ed-eventi/manda-un-webhook-di-prova.md): Scope: `webhooks:write`.
- [Elenca le consegne dei webhook](https://docs.dentalspace.ai/api-reference/webhook-ed-eventi/elenca-le-consegne-dei-webhook.md): Scope: `webhooks:read`.
- [Una consegna, con i suoi tentativi](https://docs.dentalspace.ai/api-reference/webhook-ed-eventi/una-consegna-con-i-suoi-tentativi.md): Scope: `webhooks:read`.
- [Rimanda una consegna](https://docs.dentalspace.ai/api-reference/webhook-ed-eventi/rimanda-una-consegna.md): Scope: `webhooks:write`.
- [Riferimento completo](https://docs.dentalspace.ai/api/riferimento-completo.md): Tutti gli endpoint dell'API v1 in una pagina: parametri, corpo, risposte ed errori.
- [Documentazione per LLM e agenti](https://docs.dentalspace.ai/ia/panoramica.md): URL da dare a un LLM per leggere tutta la documentazione in una richiesta, indice llms.txt, pagine Markdown, specifica OpenAPI e server MCP.
- [Prompt per agenti](https://docs.dentalspace.ai/ia/prompt-agenti.md): Prompt da incollare in Claude, ChatGPT o Cursor per integrare l'API v1 di dentalspace.

## OpenAPI Specs

- [openapi](/openapi.json)


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