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

# API 変更履歴

> Living Security Public API のコントラクトバージョンと変更内容です。

Living Security Public API では、日付ベースのコントラクトバージョン
(`YYYY-MM-DD`)を使用します。公開されている OpenAPI ドキュメントにはコントラクトバージョンが
`info["x-contract-version"]` として埋め込まれており、各オペレーションのライフサイクルステージは
`x-lifecycle-stage`(`preview`、`compatibility`、または `ga`)として宣言されています。

* 最新の仕様は、常に
  [`/v1-reference/openapi-v1.json`](/v1-reference/openapi-v1.json) で確認できます。
* バージョン別のリファレンススナップショットは
  `/v1-reference/openapi/<version>.json` で入手できます(例:
  [`/v1-reference/openapi/2026-07-01.json`](/v1-reference/openapi/2026-07-01.json))。

後方互換性のある追加的な変更(新しいオペレーションや新しい任意フィールドなど)は、
現行のコントラクトバージョン内で提供されます。新しいコントラクトバージョンは、
破壊的変更がある場合にのみ公開され、変更内容と移行方法を説明するエントリーが本ページに掲載されます。

## ドキュメントの更新

**2026-08-25** — `/v1` ガイドおよび OpenAPI の `servers` 一覧に、現在稼働中の
米国および EU のリージョナルホストが明記されました。これはドキュメント上の補足説明であり、
コントラクトバージョンに変更はありません。詳細は[リージョン](/ja/developers/v1/regions)を参照してください。

## 2026-07-01

`/v1` Public API は、このコントラクトバージョンをサポートしています。
`Living-Security-Version: 2026-07-01` を使用してバージョンを固定するか、サービスアカウントに割り当てられている既定のバージョンを使用してください。

最初のリクエストについては [API クイックスタート](/ja/developers/v1/quickstart)、
API キーと OAuth については[認証](/ja/developers/v1/authentication)、
適切なホストについては[リージョン](/ja/developers/v1/regions)を参照してください。

## 2026-08-05

この日付は、従来の `/api/v1` 互換コントラクトを個別に示すものです。
新しい `/v1` API の `Living-Security-Version` 値ではありません。

* **人**: 組織内のユーザーの検索(`GET /people/search`)と、
  個別ユーザーのメンバーシップの取得(`GET /people/{personId}/membership`)を行います。
* **API アクセスキー**: API アクセスキーの作成、一覧表示、ローテーション、失効を行います
  (`POST /access-keys`、`GET /access-keys`、`POST /access-keys/{id}/rotate`、
  `DELETE /access-keys/{id}`)。

このバージョンのすべてのオペレーションは、ライフサイクルステージ `compatibility` で公開されています。
認証、ページネーション、エラー処理については [Public API の概要](/ja/developers/public-api/overview)を、
このコントラクトの進化の方針については
[互換性と非推奨に関するポリシー](/ja/developers/public-api/overview#%E4%BA%92%E6%8F%9B%E6%80%A7%E3%81%A8%E9%9D%9E%E6%8E%A8%E5%A5%A8%E5%8C%96)を参照してください。


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