API
메모 추가
한 수준에 두는 최대 20,000자의 메모로, 보통 1~2초 안에 준비됩니다.
POST/knowledge/notes
워크스페이스에 실제 호출을 실행합니다.
POST /knowledge/notes
한 수준에 두는 최대 20,000자의 메모로, 보통 1~2초 안에 준비됩니다.
예시
knowledge:write가 필요합니다. title은 최대 200자, body는 최대 20,000자이며 원하면 Markdown으로 씁니다. 워크스페이스 전체라면 scope를 빼세요. pinned는 메모를 그 수준의 모든 프롬프트에 넣습니다(고정된 메모는 수준마다 최대 2,000자). 메모와 함께 201로 응답합니다.
curl -X POST "$OE/knowledge/notes" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "scope": "@acme.com", "title": "Refunds", "body": "Refunds are paid within 14 days of the return reaching our warehouse.", "pinned": true }'{ "object": "knowledge_item", "id": "kb_8c1f4a2b9d7e3f60a5c7b21d", "kind": "note", "scope": "@acme.com", "level": "domain", "title": "Refunds", "url": null, "fileName": null, "mimeType": null, "sizeBytes": null, "pinned": true, "status": "ready", "failure": null, "chunks": 1, "chars": 71, "origin": "api", "createdBy": "usr_5f2a9c71", "createdAt": "2026-10-08T09:12:44.000Z", "updatedAt": "2026-10-08T09:12:44.000Z", "indexedAt": "2026-10-08T09:12:45.000Z"}항목을 바꾸려면 그 수준이 덮는 모든 주소에 닿아야 합니다. 워크스페이스 전체에는 모든 주소가, 도메인에는 도메인 전체가, 주소에는 그 주소가 필요합니다. 특정 주소로 제한된 키나 앱은 그 주소, 또는 통째로 가진 도메인에서만 항목을 바꿀 수 있습니다.
워크스페이스도, 그 도메인도, 그 주소도 아닌 수준은 422 invalid_knowledge_scope이고, 키가 닿지 않는 수준은 403 knowledge_scope_not_reached입니다. 같은 요청을 두 번 보내면 메모가 두 개 추가됩니다.