Memory API
개요
REST 베이스 URL 과 엔드포인트 지도.
Memory API 는 백엔드에서 워크스페이스를 검색하고 메모리를 추가·관리하는 REST 표면입니다. 워크스페이스 API 키 하나로 인증하며, 모든 응답은 공통 envelope 을 씁니다.
베이스 URL
https://api.memory.incapi.memory.inc 는 경로 앞에 /api 를 붙여 라우팅합니다. 즉 /v1/search → 내부 /api/v1/search. 같은 엔드포인트를 https://app.memory.inc/api/v1/search 로도 호출할 수 있지만 캐노니컬 베이스는 api.memory.inc 입니다.
엔드포인트 지도
| 메서드 | 경로 | 설명 |
|---|---|---|
| POST | /v1/search | 워크스페이스 검색 — 답변 + 인용 |
| POST | /v1/search/stream | 스트리밍 검색 (SSE) — 같은 결과를 토큰 단위로 |
| POST | /v1/memories | 메모리 추가/업서트 |
| GET | /v1/models | 답변 LLM 카탈로그 |
| GET · POST | /v1/skills | 스킬 목록·생성 |
| GET · PATCH · DELETE | /v1/skills/{id} | 스킬 조회·수정·삭제 |
| POST | /sources/api/ingest | 문서·첨부 수집 |
| GET · DELETE | /sources/api/items | 항목 조회·삭제 |
인증
모든 엔드포인트는 워크스페이스 API 키를 Bearer 토큰으로 받습니다. /v1/search·/v1/search/stream·/v1/models·/v1/memories·수집은 OAuth 액세스 토큰도 받으며, 이 경우 동의한 사용자로서 동작합니다(OAuth 애플리케이션 참고). 스킬·앱·커넥터는 워크스페이스 키 전용입니다.
Authorization: Bearer pwk_YOUR_KEY워크스페이스 API 키로 호출하면 /v1/* 는 팀 스코프입니다 — 워크스페이스 공유 자료만 다루고 개인 자료는 제외됩니다. (OAuth 토큰은 사용자로서 동작해 본인 개인 자료까지 포함합니다.) 자세한 내용은 인증 참고.
커넥터 관리 (고급)
워크스페이스 키로 연동(커넥터)을 프로그래밍으로 다루는 엔드포인트도 있습니다.
| 메서드 | 경로 | 설명 |
|---|---|---|
| GET | /v1/apps | 연동 가능한 앱 카탈로그 |
| GET | /v1/connections | 워크스페이스 커넥터 설치 목록 |
| PATCH · DELETE | /v1/connections/{id} | 일시중지·재개·해제 |
| POST | /v1/connections/{id}/sync | 재동기화 트리거 |
제3자 앱이 다른 사용자의 데이터에 동의 기반으로 접근하는 OAuth 통합은 OAuth 애플리케이션 을 참고하세요.