> ## 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 리전 호스트가 명시되었습니다. 이는 문서를 명확하게 보완한 것이며, 계약 버전은 변경되지 않았습니다. [리전](/ko/developers/v1/regions)을 참조하십시오.

## 2026-07-01

`/v1` Public API는 이 계약 버전을 지원합니다. `Living-Security-Version: 2026-07-01`를 사용하여 버전을 고정하거나, 서비스 계정에 지정된 기본 버전을 사용하십시오.

첫 번째 요청은 [API 빠른 시작](/ko/developers/v1/quickstart)을, API 키와 OAuth는 [인증](/ko/developers/v1/authentication)을, 올바른 호스트는 [리전](/ko/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 개요](/ko/developers/public-api/overview)를, 이 계약이 발전하는 방식은 [호환성 및 지원 중단 정책](/ko/developers/public-api/overview#%ED%98%B8%ED%99%98%EC%84%B1-%EB%B0%8F-%EC%A7%80%EC%9B%90-%EC%A4%91%EB%8B%A8)을 참조하십시오.


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