Skip to main content
Living Security Public API では、日付ベースのコントラクトバージョン (YYYY-MM-DD)を使用します。公開されている OpenAPI ドキュメントにはコントラクトバージョンが info["x-contract-version"] として埋め込まれており、各オペレーションのライフサイクルステージは x-lifecycle-stage(preview、compatibility、または ga)として宣言されています。 後方互換性のある追加的な変更(新しいオペレーションや新しい任意フィールドなど)は、 現行のコントラクトバージョン内で提供されます。新しいコントラクトバージョンは、 破壊的変更がある場合にのみ公開され、変更内容と移行方法を説明するエントリーが本ページに掲載されます。

​
ドキュメントの更新

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

​
2026-07-01

/v1 Public API は、このコントラクトバージョンをサポートしています。 Living-Security-Version: 2026-07-01 を使用してバージョンを固定するか、サービスアカウントに割り当てられている既定のバージョンを使用してください。 最初のリクエストについては API クイックスタート、 API キーと OAuth については認証、 適切なホストについてはリージョンを参照してください。

​
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 の概要を、 このコントラクトの進化の方針については 互換性と非推奨に関するポリシーを参照してください。