> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog delle API

> Versioni del contratto e modifiche alle API pubbliche di Living Security.

Le API pubbliche di Living Security utilizzano versioni del contratto basate sulla data
(`YYYY-MM-DD`). Il documento OpenAPI pubblicato incorpora la propria versione del contratto come
`info["x-contract-version"]` e ogni operazione dichiara la propria fase del ciclo di vita
come `x-lifecycle-stage` (`preview`, `compatibility` o `ga`).

* La specifica corrente è sempre disponibile all'indirizzo
  [`/v1-reference/openapi-v1.json`](/v1-reference/openapi-v1.json).
* Gli snapshot di riferimento versionati sono disponibili all'indirizzo
  `/v1-reference/openapi/<version>.json`, ad esempio
  [`/v1-reference/openapi/2026-07-01.json`](/v1-reference/openapi/2026-07-01.json).

Le modifiche additive e retrocompatibili (nuove operazioni, nuovi campi opzionali)
vengono rilasciate all'interno della versione corrente del contratto. Una nuova versione del contratto viene pubblicata
solo per le modifiche che causano incompatibilità, insieme a una voce in questa pagina che descrive la
modifica e il percorso di migrazione.

## Aggiornamenti della documentazione

**2026-08-25** — Le guide `/v1` e l'elenco `servers` di OpenAPI ora indicano gli host regionali attivi
per gli Stati Uniti e l'UE. Si tratta di un chiarimento della documentazione. La versione del
contratto rimane invariata. Consultare [Regioni](/it/developers/v1/regions).

## 2026-07-01

Le API pubbliche `/v1` supportano questa versione del contratto. È possibile bloccarla tramite
`Living-Security-Version: 2026-07-01` oppure utilizzare la versione predefinita assegnata
al proprio service account.

Consultare la [guida rapida alle API](/it/developers/v1/quickstart) per la prima richiesta,
[Autenticazione](/it/developers/v1/authentication) per le chiavi API e OAuth e
[Regioni](/it/developers/v1/regions) per l'host corretto.

## 2026-08-05

Questa data identifica il contratto di compatibilità `/api/v1` legacy, distinto dagli altri.
Non è un valore `Living-Security-Version` per le nuove API `/v1`.

* **Persone**: cercare le persone dell'organizzazione (`GET /people/search`) e recuperare l'appartenenza
  di una persona (`GET /people/{personId}/membership`).
* **Chiavi di accesso API**: creare, elencare, ruotare e revocare le chiavi di accesso API
  (`POST /access-keys`, `GET /access-keys`, `POST /access-keys/{id}/rotate`,
  `DELETE /access-keys/{id}`).

Tutte le operazioni di questa versione sono pubblicate nella fase del ciclo di vita `compatibility`. Consultare la [panoramica delle API pubbliche](/it/developers/public-api/overview) per
autenticazione, paginazione e gestione degli errori, e la
[policy di compatibilità e deprecazione](/it/developers/public-api/overview#compatibilit%C3%A0-e-deprecazione)
per l'evoluzione di questo contratto.


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