> ## 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.

# Journal des modifications de l'API

> Versions de contrat et modifications de l'API publique de Living Security.

L'API publique de Living Security utilise des versions de contrat basées sur la date
(`YYYY-MM-DD`). Le document OpenAPI publié intègre sa version de contrat sous la forme `info["x-contract-version"]`, et chaque opération déclare son étape du cycle de vie
sous la forme `x-lifecycle-stage` (`preview`, `compatibility` ou `ga`).

* La spécification actuelle est toujours disponible à l'adresse
  [`/v1-reference/openapi-v1.json`](/v1-reference/openapi-v1.json).
* Des instantanés de référence versionnés sont disponibles à l'adresse
  `/v1-reference/openapi/<version>.json`, par exemple
  [`/v1-reference/openapi/2026-07-01.json`](/v1-reference/openapi/2026-07-01.json).

Les modifications additives et rétrocompatibles (nouvelles opérations, nouveaux champs facultatifs)
sont livrées dans la version de contrat actuelle. Une nouvelle version de contrat est publiée
uniquement pour les modifications incompatibles, accompagnée d'une entrée sur cette page décrivant la
modification et la marche à suivre pour la migration.

## Mises à jour de la documentation

**2026-08-25** — Les guides `/v1` et la liste `servers` d'OpenAPI nomment désormais les hôtes régionaux actifs
des États-Unis et de l'UE. Il s'agit d'une clarification de la documentation. La version
du contrat demeure inchangée. Consultez [Régions](/fr-CA/developers/v1/regions).

## 2026-07-01

L'API publique `/v1` prend en charge cette version de contrat. Épinglez-la à l'aide de
`Living-Security-Version: 2026-07-01`, ou utilisez la version par défaut attribuée
à votre compte de service.

Consultez le [guide de démarrage rapide de l'API](/fr-CA/developers/v1/quickstart) pour votre première requête,
[Authentification](/fr-CA/developers/v1/authentication) pour les clés d'API et OAuth, et
[Régions](/fr-CA/developers/v1/regions) pour connaître l'hôte approprié.

## 2026-08-05

Cette date désigne le contrat de compatibilité `/api/v1` hérité distinct.
Il ne s'agit pas d'une valeur `Living-Security-Version` pour la nouvelle API `/v1`.

* **Personnes** : rechercher les personnes de l'organisation (`GET /people/search`) et récupérer l'appartenance
  d'une personne (`GET /people/{personId}/membership`).
* **Clés d'accès à l'API** : créer, lister, effectuer la rotation et révoquer des clés d'accès à l'API
  (`POST /access-keys`, `GET /access-keys`, `POST /access-keys/{id}/rotate`,
  `DELETE /access-keys/{id}`).

Toutes les opérations de cette version sont publiées à l'étape `compatibility` du cycle de vie.
Consultez la [vue d'ensemble de l'API publique](/fr-CA/developers/public-api/overview) pour
l'authentification, la pagination et la gestion des erreurs, ainsi que la
[politique de compatibilité et de dépréciation](/fr-CA/developers/public-api/overview#compatibilit%C3%A9-et-d%C3%A9su%C3%A9tude)
pour savoir comment ce contrat évolue.


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