diff --git a/docs/api.md b/docs/api.md
index 07429b3..30a0118 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -19,9 +19,16 @@ Base URL: `/api`
 ### GET /members
 멤버 목록 조회
 
-### GET /members/:id
+### GET /members/:name
 멤버 상세 조회
 
+**Parameters:**
+- `name` - 멤버 이름 (한글 또는 영문, 대소문자 무관)
+
+**예시:**
+- `/members/박지원` - 한글명으로 조회
+- `/members/jiwon` - 영문명으로 조회
+
 ---
 
 ## 앨범
@@ -66,6 +73,11 @@ Base URL: `/api`
   ]
 }
 ```
+
+**특수 일정 ID 형식:**
+- 생일: `birthday-{year}-{nameEn}` (예: `birthday-2026-jiwon`)
+- 데뷔: `debut-{year}` (예: `debut-2018`)
+- 주년: `anniversary-{year}` (예: `anniversary-2026`)
 ※ `time`: 시간이 없는 일정은 `null`, 00:00 시간은 `"00:00:00"`으로 반환
 ```