diff --git a/journey/troubleshooting/251128_ir_valuation_frontend_setup.md b/journey/troubleshooting/251128_ir_valuation_frontend_setup.md
index 5925e75..8912b04 100644
--- a/journey/troubleshooting/251128_ir_valuation_frontend_setup.md
+++ b/journey/troubleshooting/251128_ir_valuation_frontend_setup.md
@@ -169,6 +169,18 @@ Body: {
 
 3. **베이지안 학습**: 피드백 수집 및 학습 데이터 구성
 
+## API 헤더 필수 사항
+
+**문제**: API 호출 시 `X-Team-Id header required` 에러 발생
+
+**원인**: skill-rag-file이 파일을 `/mnt/hdd/data/documents/{team_id}/` 경로에 저장하므로 team_id 필요
+
+**해결**: 프론트엔드 API 호출에 헤더 추가
+- `X-Team-Id: 79441171-3951-4870-beb8-916d07fe8be5` (기본 team_id)
+- `X-User-Id: {user_id}` (사용자 ID)
+
+**테스트 결과**: 헤더 추가 후 업로드 성공, `document_id` 반환 확인
+
 ## 교훈
 
 - frontend-customer 구조를 참고하여 빠르게 프로젝트 생성 가능
@@ -176,6 +188,7 @@ Body: {
 - 빌드 산출물은 `/home/admin/frontend-ir-valuation/dist/`에 저장
 - **SPA 라우팅**: nginx base path(`/ir-valuation`)와 React 라우터 경로를 일치시켜야 함
 - wouter는 base path를 자동 처리하지 않으므로 `useLocation`으로 수동 처리 필요
+- **API 헤더**: rb8001 API는 멀티테넌시를 위해 `X-Team-Id`, `X-User-Id` 헤더 필수
 
 ---