문서로 건너뛰기
API

지식 항목 목록

지식 베이스의 항목을 최신순으로, 한 페이지씩.

GET/knowledge

워크스페이스에 실제 호출을 실행합니다.

GET /knowledge

지식 베이스의 항목을 최신순으로, 한 페이지씩.

예시

knowledge:read가 필요합니다. 모든 필터는 선택 사항입니다. scope는 한 수준, level은 수준의 종류(workspace, domain, address), kind는 메모, 파일, 링크, status는 한 상태, pinned는 고정된 메모만 남기고, q는 제목, 파일 이름, 링크의 단어와 맞춥니다. limit은 최대 100이고 기본값은 50이며, cursor에는 이전 페이지의 nextCursor를 넣습니다.

curl
curl "$OE/knowledge?level=domain&limit=20" -H "$AUTH"
응답
{  "object": "list",  "data": [{      "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"    }],  "hasMore": false,  "nextCursor": null}

특정 주소로 제한된 키나 앱은 워크스페이스 전체의 항목과 그 주소 및 그 도메인의 항목을 봅니다. 볼 수 없는 수준은 아무것도 나열하지 않습니다.

이 목록이 건네지 않은 커서는 400 invalid_cursor입니다.

레퍼런스