Memory API

스킬

워크스페이스 스킬 CRUD (팀 스코프).

스킬은 워크스페이스가 정의한 재사용 작업 레시피입니다. 인앱 SkillWizard·MCP skills 툴과 같은 workspace_skill 행을 다룹니다. 질의가 스킬과 매칭되면 검색이 자동으로 적용해 matched_skill 로 돌려줍니다.

API 로 다루는 스킬은 항상 팀(workspace) 스코프이며 워크스페이스 API 키(pwk_)로만 인증됩니다 — OAuth 액세스 토큰은 받지 않고, 멤버 개인 스킬은 노출·관리하지 않습니다.

GET/v1/skills

instructions 본문은 제외하고 메타데이터만 반환합니다.

{
  "ok": true,
  "data": {
    "skills": [
      {
        "id": "…", "name": "주간 보고", "description": "…",
        "surfaces": ["web", "slack"], "scope": "workspace",
        "enabled": true, "created_at": "…", "updated_at": "…"
      }
    ]
  }
}

생성

POST/v1/skills

필드	타입	필수	설명
`name`	string	필수	스킬 이름 (1–200자)
`description`	string	필수	언제 쓰는지 (1–2000자)
`instructions`	string	필수	전체 지침 (1–100000자)
`surfaces`	string[]	기본 전체	적용 표면 (`mcp` · `web` · `slack`)
`enabled`	boolean	기본 true	활성 여부

성공 시 201 과 { "ok": true, "data": { "id": "…" } }. 이름이 중복이면 409 conflict.

curl -X POST 'https://api.memory.inc/v1/skills' \
  -H 'authorization: Bearer pwk_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d '{
    "name": "주간 보고",
    "description": "주간 진행 상황을 표준 형식으로 요약할 때",
    "instructions": "1. 지난 7일간 결정·이슈를 모은다\n2. ..."
  }'

조회 · 수정 · 삭제

GET/v1/skills/{id}

PATCH/v1/skills/{id}

DELETE/v1/skills/{id}

GET — 전체 지침(instructions)까지 포함해 반환합니다.
PATCH — name · description · instructions · surfaces · enabled 중 일부만 보내 수정합니다.
DELETE — 스킬을 삭제합니다 → { "ok": true, "data": { "id": "…", "deleted": true } }.

curl -X PATCH 'https://api.memory.inc/v1/skills/SKILL_ID' \
  -H 'authorization: Bearer pwk_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d '{ "enabled": false }'

스킬

목록

생성

조회 · 수정 · 삭제