관리

설정, 사용자, 와처, 감사 로그 — 운영자가 쓰는 API입니다. 대부분 관리자 권한이 필요합니다.

설정

메서드	경로	하는 일
GET	/api/settings	전체 설정
PUT	/api/settings	설정 저장 (바꿀 항목만)
POST	/api/settings/test-platform	플랫폼 연동 키를 실제로 시험
POST	/api/settings/mcp/refresh	MCP 서버 목록 갱신 (본문에 serverId, 생략하면 전체)

AI 공급자 설정은 ai 아래 있습니다.

{
  "ai": { "provider": "anthropic", "model": "...", "baseUrl": "..." }
}

키 값 자체는 응답에 담기지 않습니다. 저장은 되지만 다시 읽을 수 없습니다.

브랜딩

메서드	경로	하는 일
PUT	/api/settings	브랜드 이름 ({ "brandName": "..." })
POST	/api/settings/branding-logo	로고 업로드 (mime, dataBase64)
DELETE	/api/settings/branding-logo	로고 제거

사용자

메서드	경로	하는 일
GET	/api/users	사용자 목록
GET	/api/users/directory	공유 대상 고르기용 간단 목록
POST	/api/users	사용자 생성 (userId, password, name, role)
PUT	/api/users/{id}	이름·역할 변경
POST	/api/users/{id}/password	비밀번호 재설정
DELETE	/api/users/{id}	삭제
POST	/api/users/{id}/avatar	프로필 사진 (mime, dataBase64)
GET	/api/avatar/{loginId}	프로필 사진 읽기

{id} 는 URL 인코딩합니다.

와처

와처는 정해진 주기로 돌면서 조건에 걸리면 알리는 감시 규칙입니다.

메서드	경로	하는 일
GET	/api/watchers	목록
POST	/api/watchers/draft	자연어 설명에서 와처 초안 만들기 (본문에 text)
POST	/api/watchers	생성 (name, instruction, intervalMinutes)
PATCH	/api/watchers/{id}	수정
DELETE	/api/watchers/{id}	삭제
POST	/api/watchers/{id}/run	주기를 기다리지 않고 지금 실행

초안 API가 있는 이유는 조건을 직접 쓰는 것보다 "3라인 압축기 토출 온도가 90도 넘으면 알려줘"처럼 말하는 쪽이 빠르기 때문입니다.

알림

메서드	경로	하는 일
GET	/api/notifications?limit={n}&offset={n}&q={검색어}	알림 목록
GET	/api/notifications/unread	안 읽은 것
POST	/api/notifications/seen	전부 읽음 처리
GET	/api/notifications/stream	새 알림을 스트리밍으로 받기

감사와 사용량

메서드	경로	하는 일
GET	/api/audit?offset={n}&limit={n}&q={검색어}	감사 로그 (기본 50건)
GET	/api/usage?days={n}	사용량 (기본 30일)
GET	/api/stats/overview?days={n}	통계 요약
GET	/api/activity	최근 활동

템플릿과 갤러리

메서드	경로	하는 일
GET	/api/templates	템플릿 목록
DELETE	/api/templates/{key}	템플릿 삭제
GET	/api/gallery/{id}/doc	갤러리 항목의 설명 문서

온보딩

GET /api/onboarding

처음 접속한 사용자에게 보여줄 안내 상태를 받습니다.