API 레퍼런스

daemon은 네 가지 HTTP 표면을 제공합니다.

인증

공개 상태 확인 엔드포인트를 제외한 REST 경로는 Bearer token이 필요합니다.

Authorization: Bearer {token}

/eve/v1/health를 제외한 경로는 daemon Bearer 인증이 필요합니다. 실제 workflow 내부 경로와 loopback 포트는 외부에 노출하지 않습니다.

Method	Path	설명
GET	`/eve/v1/health`	Local Eve 준비 상태
POST	`/eve/v1/session`	첫 메시지와 함께 세션 생성
GET	`/eve/v1/session/:sessionId`	세션 snapshot 조회
GET	`/eve/v1/session/:sessionId/stream`	durable 이벤트 스트림
POST	`/eve/v1/session/:sessionId`	다음 메시지 queue 또는 입력 요청 응답
POST	`/eve/v1/session/:sessionId/cancel`	현재 turn 취소 요청
GET	`/api/eve/sessions`	모바일용 Local Eve 세션 인덱스

Method	Path	설명
POST	`/api/codex-bridge/request`	메모리·스케줄·브라우저·워크스페이스 요청
GET	`/api/codex-bridge/events`	비채팅 유틸리티 SSE
GET	`/api/codex-bridge/assets/:sessionId/:ref`	호환 attachment asset

세션별 요청 종류

codex:session:*, steering, approval-control, handoff 요청은 이 bridge에서 HTTP 410을 반환합니다. chat lifecycle은 Local Eve API만 사용합니다.

Method	Path	설명
GET	`/api/browser/:agentId/session-manager`	쿠키 등록용 HTML 도우미
POST	`/api/browser/:agentId/cookies/register`	현재 브라우저 쿠키 저장
GET	`/api/browser/:agentId/cookies/status`	저장된 쿠키 상태 조회
GET	`/api/agents/:agentId/avatar`	에이전트 아바타 이미지

Method	Path	설명
GET	`/api/utility/storage-stats`	저장소 통계
GET	`/api/utility/usage-report`	사용량 리포트
GET	`/api/utility/daemon-logs`	최근 daemon 로그
GET	`/api/utility/app-workspaces`	앱 워크스페이스 목록
GET	`/api/utility/app-workspace-templates`	앱 워크스페이스 템플릿 목록
GET	`/api/utility/app-workspace-template-preview`	템플릿 미리보기
GET	`/api/utility/skill-workspaces`	스킬 워크스페이스 목록
GET	`/api/utility/skill-workspaces/:workspaceId/content`	스킬 워크스페이스 파일 내용
GET	`/api/utility/skill-projects`	스킬 프로젝트 목록
GET	`/api/utility/skill-projects/:projectId`	스킬 프로젝트 상세
GET	`/api/utility/codex-session-search`	Codex 세션 transcript 검색
GET	`/api/utility/skills`	설치된 스킬 목록
GET	`/api/utility/skills/:skillName`	스킬 상세
GET	`/api/utility/codex-models`	사용 가능한 Codex 모델 ID
GET	`/api/utility/mcp-servers`	MCP 서버 목록
GET	`/api/utility/daemon-health`	daemon health snapshot
GET	`/api/utility/daemon-config`	daemon 설정 조회
PATCH	`/api/utility/daemon-config`	daemon 설정 일부 갱신

Method	Path	설명
POST	`/api/maintenance/app-workspaces`	앱 워크스페이스 생성
POST	`/api/maintenance/app-workspaces/:workspaceId/start`	dev 서버 시작
POST	`/api/maintenance/app-workspaces/:workspaceId/stop`	dev 서버 중지
POST	`/api/maintenance/app-workspaces/:workspaceId/build`	빌드 실행
DELETE	`/api/maintenance/app-workspaces/:workspaceId`	앱 워크스페이스 삭제
POST	`/api/maintenance/skill-workspaces`	스킬 워크스페이스 생성
POST	`/api/maintenance/skill-workspaces/:workspaceId/save`	스킬 워크스페이스 저장
POST	`/api/maintenance/skill-workspaces/:workspaceId/smoke-test`	스모크 테스트
DELETE	`/api/maintenance/skill-workspaces/:workspaceId`	스킬 워크스페이스 삭제
POST	`/api/maintenance/skill-projects`	스킬 프로젝트 생성
POST	`/api/maintenance/skill-projects/:projectId/browser-bind`	브라우저 바인딩
POST	`/api/maintenance/skill-projects/:projectId/browser-unbind`	브라우저 바인딩 해제
POST	`/api/maintenance/skill-projects/:projectId/step-update`	스텝/녹화 상태 갱신
POST	`/api/maintenance/skill-projects/:projectId/verify`	검증 실행
POST	`/api/maintenance/skill-projects/:projectId/publish`	스킬 발행
POST	`/api/maintenance/agents/:agentId/avatar`	아바타 업로드
DELETE	`/api/maintenance/agents/:agentId/avatar`	아바타 삭제