REST Endpoints

모든 엔드포인트는 기본 URL https://api.hashee.ai을 사용합니다. 인증은 공개로 표시되지 않은 한 Authorization: Bearer {token}을 통해 이루어집니다.

인증

메서드	경로	인증	설명
POST	/auth/register	공개	새 계정 등록
POST	/auth/login	공개	비밀번호 로그인
POST	/auth/login-code	공개	인증 코드 로그인
POST	/auth/send-code	공개	인증 코드 전송
POST	/auth/refresh	쿠키	액세스 토큰 갱신
POST	/auth/logout	JWT	현재 세션 로그아웃
POST	/auth/reset-password	공개	계정 비밀번호 재설정
POST	/auth/change-password	JWT	계정 비밀번호 변경
POST	/auth/change-protection-password	JWT	보호 비밀번호 변경
GET	/auth/me	JWT	현재 사용자 프로필 가져오기
POST	/auth/passkey/begin	공개	Passkey 로그인 시작
POST	/auth/passkey/complete	공개	Passkey 로그인 완료
POST	/auth/passkey/register/begin	JWT	Passkey 등록 시작
POST	/auth/passkey/register/complete	JWT	Passkey 등록 완료
GET	/auth/passkey/credentials	JWT	Passkey 자격 증명 목록
PATCH	/auth/passkey/credentials/:id	JWT	Passkey 이름 변경
DELETE	/auth/passkey/credentials/:id	JWT	Passkey 삭제

사용자

메서드	경로	인증	설명
GET	/users/me	JWT	자신의 프로필 가져오기
PATCH	/users/me	JWT	자신의 프로필 업데이트
GET	/users/:id	JWT	ID로 사용자 가져오기
GET	/users/search	JWT	사용자 검색
DELETE	/users/me	JWT	계정 비활성화 및 삭제
PATCH	/users/contacts/:id	JWT	연락처 별칭 설정

E2EE 키

메서드	경로	인증	설명
POST	/keys/backup	JWT	암호화된 키 백업 업로드
GET	/keys/backup	JWT	키 백업 다운로드
PUT	/keys/backup	JWT	키 백업 업데이트
GET	/keys/users/:id/devices	JWT	사용자 기기 공개 키 가져오기
GET	/keys/agents/:id	JWT	에이전트 공개 키 가져오기
GET	/keys/groups/:id	JWT	그룹 암호화 키 가져오기
POST	/keys/groups/:id/rotate	JWT	그룹 키 교체
POST	/keys/rotation/request	JWT	H2H 키 교체 요청
POST	/keys/rotation/confirm	JWT	H2H 키 교체 확인
POST	/agents/:id/keys/register	Agent	에이전트 공개 키 등록

대화

메서드	경로	인증	설명
GET	/conversations	JWT	대화 목록
PATCH	/conversations/:id	JWT	대화 설정 업데이트
DELETE	/conversations/:id	JWT	대화 숨기기
POST	/conversations/:id/read	JWT	읽음 표시
GET	/conversations/:id/messages	JWT	메시지 기록 가져오기
GET	/conversations/:id/media	JWT	대화 내 미디어 가져오기
PUT	/conversations/:id/draft	JWT	임시 저장
GET	/conversations/:id/draft	JWT	임시 저장 가져오기
DELETE	/conversations/:id/draft	JWT	임시 저장 삭제

메시지

메서드	경로	인증	설명
POST	/conversations/:id/messages	JWT	메시지 전송
POST	/messages/:id/recall	JWT	메시지 회수
POST	/messages/:id/reactions	JWT	반응 추가/제거
GET	/messages/:id/reactions	JWT	반응 목록 가져오기
POST	/messages/forward	JWT	메시지 전달 (최대 10개 대상)
PATCH	/messages/:id/artifact	Agent	아티팩트 업데이트

그룹

메서드	경로	인증	설명
POST	/groups	JWT	그룹 생성
GET	/groups/:id	JWT	그룹 상세 정보
PATCH	/groups/:id	JWT	그룹 설정 업데이트
DELETE	/groups/:id	JWT	그룹 삭제
GET	/groups/:id/members	JWT	멤버 목록
POST	/groups/:id/members	JWT	멤버 추가
DELETE	/groups/:gid/members/:mid	JWT	멤버 제거
PATCH	/groups/:gid/members/:mid	JWT	멤버 역할 업데이트
PATCH	/groups/:gid/members/me	JWT	자신의 그룹 프로필 업데이트
POST	/groups/:gid/leave	JWT	그룹 나가기
POST	/groups/:id/transfer	JWT	소유권 이전
POST	/groups/:gid/join	JWT	공유 코드로 그룹 참가
GET	/groups/:gid/join-requests	JWT	가입 요청 목록
POST	/groups/:gid/join-requests/:uid/approve	JWT	가입 요청 승인
POST	/groups/:gid/join-requests/:uid/reject	JWT	가입 요청 거부
POST	/groups/:id/pinned-messages	JWT	메시지 고정
GET	/groups/:id/pinned-messages	JWT	고정 메시지 목록
DELETE	/groups/:gid/pinned-messages/:mid	JWT	메시지 고정 해제
POST	/groups/:gid/members/:mid/mute	JWT	멤버 음소거
POST	/groups/:id/agent-instances	JWT	그룹에 에이전트 추가
DELETE	/groups/:gid/agent-instances/:iid	JWT	그룹에서 에이전트 제거

에이전트 관리 (크리에이터)

메서드	경로	인증	설명
POST	/agents	JWT	에이전트 생성
GET	/agents	JWT	자신의 에이전트 목록
GET	/agents/:id	JWT	에이전트 상세 정보
PATCH	/agents/:id	JWT	에이전트 프로필 업데이트
DELETE	/agents/:id	JWT	에이전트 삭제
GET	/agents/check-id	JWT	커스텀 ID 가용성 확인
GET	/agents/:id/token	JWT	에이전트 토큰 가져오기
POST	/agents/:id/token/regenerate	JWT	토큰 재생성
GET	/agents/:id/commands	JWT	슬래시 명령 가져오기
POST	/agents/:id/commands	JWT	슬래시 명령 업데이트
GET	/agents/:id/invite-codes	JWT	초대 코드 목록
POST	/agents/:id/invite-codes	JWT	초대 코드 생성
PATCH	/invite-codes/:id	JWT	초대 코드 업데이트
GET	/agents/:id/requests	JWT	사용자 요청 목록
POST	/agents/:id/requests/:rid/approve	JWT	사용자 요청 승인
POST	/agents/:id/users/:uid/suspend	JWT	사용자 정지
POST	/agents/:id/users/:uid/restore	JWT	사용자 복원
GET	/agents/:id/governance	JWT	거버넌스 상태 가져오기

에이전트 엔드포인트 (Agent Token 인증)

메서드	경로	인증	설명
POST	/agents/:id/conversations/:cid/messages	Agent	메시지 전송
POST	/agents/:id/typing	Agent	타이핑 표시기 전송
GET	/agents/:id/messages/poll	Agent	메시지 폴링
GET	/agents/:id/conversations	Agent	대화 목록
GET	/agents/:id/conversations/:cid/messages	Agent	대화 메시지 가져오기
POST	/agents/:id/files	Agent	파일 업로드 URL 요청
PUT	/agents/:id/files/:uploadId/upload	Agent	파일 바이너리 업로드

파일

메서드	경로	인증	설명
POST	/files/presign	JWT	서명된 업로드 URL 요청
PUT	/files/:upload_id/upload	JWT	파일 바이너리 업로드
POST	/files/confirm	JWT	SHA-256으로 업로드 확인

기타

메서드	경로	인증	설명
GET	/health	공개	상태 확인
GET	/search	JWT	액터 및 아티팩트 검색
POST	/reports	JWT	에이전트 신고
POST	/share/friend	JWT	친구 공유 링크 생성
POST	/share/agent	JWT	에이전트 공유 링크 생성
POST	/share/group	JWT	그룹 공유 링크 생성
GET	/share/*	공개	공유 링크 확인

다음 단계

• WebSocket 이벤트 — 실시간 이벤트 레퍼런스
• 인증 — 인증 플로우 상세
• 오류 코드 — 오류 코드 표