Memory API

메모리 추가

POST /v1/memories — 워크스페이스에 메모리 추가·업서트.

워크스페이스에 메모리를 추가합니다. 내부적으로 Ingest 코어를 재사용하므로 중복 제거·버전 관리·저장·색인 큐가 모두 동일하게 동작합니다.

POST/v1/memories

팀 스코프입니다 — 모든 메모리가 워크스페이스 공유로 들어갑니다.

요청 바디

필드	타입	필수	설명
`text` (또는 `content`)	string \| object	필수	메모리 본문. 문자열 또는 JSON 객체/배열
`title`	string	선택	표시 제목
`external_id`	string	선택	멱등 키. 같은 값으로 다시 호출하면 새 버전으로 업서트
`source_name`	string	기본 "API memory"	워크스페이스 내 소스 그룹 이름
`metadata`	object	선택	임의 JSON 메타데이터

응답

성공 시 201 과 함께:

{
  "ok": true,
  "data": {
    "id": "…source_item_id…",
    "status": "indexed"
  }
}

`status`	의미
`indexed`	색인 큐에 등록됨
`unchanged`	같은 내용(content hash) — 새 버전 없음
`duplicate` / `deduped`	다른 소스에 동일 내용이 이미 존재

색인은 비동기이며 임베딩이 끝나면 검색됩니다.

예시

curl -X POST 'https://api.memory.inc/v1/memories' \
  -H 'authorization: Bearer pwk_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d '{
    "text": "# 결정\n- 결제 모듈 v2 로 마이그레이션",
    "title": "주간 결정 메모",
    "external_id": "decision-2026-06-09",
    "metadata": { "team": "billing" }
  }'

JSON 객체를 그대로 본문으로 보낼 수도 있습니다.

curl -X POST 'https://api.memory.inc/v1/memories' \
  -H 'authorization: Bearer pwk_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d '{
    "external_id": "ticket-4821",
    "title": "지원 티켓 4821",
    "content": { "status": "resolved", "summary": "환불 처리 완료" }
  }'

문서·첨부파일·폴더 구조까지 다루는 더 큰 표면이 필요하면 Ingest 를 쓰세요 — /v1/memories 는 그 위의 얇은 별칭입니다.