REST

API 레퍼런스

MemoryFirst는 네이티브 REST API를 제공합니다. 같은 메모리를 MCP로도 사용할 수 있습니다(MCP 가이드 참고).

기본 URL

https://api.memoryfirst.ai/v1

인증

모든 요청에는 API 키가 필요하며, 키는 헤더 Authorization 에 담아 보냅니다:

curl https://api.memoryfirst.ai/v1/experts/{expertId}/query \
  -H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"question": "What did we promise this client?", "k": 8}'

엔드포인트

  • POST /v1/experts/{id}/sources: 새 소스 처리
  • POST /v1/experts/{id}/query: 인용과 함께 메모리 조회
  • GET /v1/experts: 워크스페이스의 전문가 목록 조회
  • POST /v1/experts: 새 전문가 생성
  • GET /v1/usage: 현재 기간의 사용량 통계
  • POST /v1/brain/event: 브레인 이벤트(결정, 블로커, 배포, 고객 연락)를 기록합니다. 이벤트 id와 함께 202를 응답합니다.

중복 없는 재시도: Idempotency-Key

네트워크가 끊긴 뒤 클라이언트가 재시도하거나 발신함을 다시 보낼 때는 POST /v1/brain/event에 직접 만든 키(공백 없는 출력 가능한 ASCII 1~255자)를 Idempotency-Key 헤더로 보내세요. 같은 워크스페이스에서 같은 키를 24시간 동안 보내면 새 이벤트를 만들지 않고 이미 생성된 이벤트를 200과 idempotent_replay: true로 반환합니다.

curl https://api.memoryfirst.ai/v1/brain/event \
  -H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: outbox-2026-11-13-0042" \
  -H "Content-Type: application/json" \
  -d '{"project": "my-project", "event_type": "decision_taken", "title": "Move blobs to R2"}'

반복된 본문이 다르면 원본 이벤트가 변경 없이 반환되며 payload_differs: true가 포함됩니다. 같은 키를 다른 프로젝트에 쓰면 422를 응답하고, 첫 요청이 아직 처리 중이면 409를 응답합니다(같은 키로 재시도하세요). MCP 도구 mf_record에서는 idempotency_key 인자를 전달하세요.

OpenAPI 3.1 전체 명세는 곧 공개됩니다. 얼리 액세스는 hola [at] memoryfirst.ai (으)로 문의해 주세요.