Memory API

검색

POST /v1/search — 워크스페이스 검색, 답변과 인용.

웹 채팅·MCP 와 같은 RAG 엔진을 단일 JSON 응답으로 노출합니다. 연결된 모든 소스(문서·메시지·메모·채팅 기록)를 통합 랭킹으로 검색합니다.

POST/v1/search

팀 스코프입니다 — 워크스페이스 공유 자료만 검색하며 개인 자료는 제외됩니다.

요청 바디

필드	타입	필수	설명
`query`	string	필수	자연어 질의 (최대 4000자)
`limit`	number	기본 20 (1–50)	인용 개수
`include_answer`	boolean	기본 true	`false` 면 LLM 합성을 건너뛰고 인용만 반환 (≈80% 절약)
`model`	string	선택	답변 LLM id (→ 모델). 모르는 id 는 기본값으로 폴백
`time_after`	ISO 8601	선택	이 시각 이후 소스로 제한
`time_before`	ISO 8601	선택	이 시각 이전 소스로 제한
`author`	string \| string[]	선택	원저자/발신자 부분일치. 배열은 OR
`mode`	`"normal"` \| `"fast"`	기본 `normal`	`fast` 는 질의이해·리랭크를 건너뛰는 저지연 모드 — 품질이 크게 떨어지니 라이브 UI 에만 쓰세요
`locale`	`"ko"` \| `"en"`	선택	답변 언어 고정 (기본: 질문 언어를 따름)

응답

{
  "ok": true,
  "data": {
    "answer": "결제 모듈은 v2 로 …",
    "citations": [
      {
        "id": "…",
        "source_item_id": "…",
        "title": "주간 결정 메모",
        "snippet": "- 결제 모듈 v2 로 이전",
        "url": "https://app.memory.inc/…",
        "author": "권도균",
        "published_at": "2026-06-09T…Z"
      }
    ],
    "matched_skill": { "name": "주간 보고", "instructions": "…" }
  }
}

필드	설명
`answer`	합성된 답변. `include_answer:false` 면 빈 문자열
`citations[].url`	사용자가 클릭해 열 수 있는 소스 링크(포커스 뷰)
`matched_skill`	질의가 워크스페이스 스킬과 매칭되면 그 레시피(이름+지침). 호출자 에이전트가 그대로 수행하도록 동봉 (없으면 필드 생략)

예시

curl -X POST 'https://api.memory.inc/v1/search' \
  -H 'authorization: Bearer pwk_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d '{
    "query": "스타노스 출시 일정",
    "limit": 8,
    "time_after": "2026-05-01T00:00:00Z"
  }'

자체 LLM 으로 합성할 거라면 인용만 받으세요.

curl -X POST 'https://api.memory.inc/v1/search' \
  -H 'authorization: Bearer pwk_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d '{ "query": "스타노스 출시 일정", "include_answer": false }'

query 는 평범한 자연어로 쓰세요. 따옴표나 AND/OR 연산자는 시맨틱 랭킹에 오히려 방해가 됩니다.