API
링크 추가
백그라운드에서 가져와 읽는 공개 웹 페이지.
POST/knowledge/links
워크스페이스에 실제 호출을 실행합니다.
POST /knowledge/links
백그라운드에서 가져와 읽는 공개 웹 페이지.
예시
knowledge:write가 필요합니다. url은 최대 2,048자의 공개 http 또는 https 주소이며 https로 저장됩니다. title이 없으면 페이지를 읽을 때까지는 링크 이름을, 그 후에는 페이지 자체의 제목을 항목 이름으로 씁니다. queued 상태의 링크와 함께 201로 응답합니다.
curl -X POST "$OE/knowledge/links" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "url": "https://acme.com/shipping" }'{ "object": "knowledge_item", "id": "kb_3e7b1d9a4c2f80e6b5a1c47d", "kind": "link", "scope": "", "level": "workspace", "title": "https://acme.com/shipping", "url": "https://acme.com/shipping", "fileName": null, "mimeType": null, "sizeBytes": null, "pinned": false, "status": "queued", "failure": null, "chunks": 0, "chars": 0, "origin": "api", "createdBy": "usr_5f2a9c71", "createdAt": "2026-10-08T09:14:02.000Z", "updatedAt": "2026-10-08T09:14:02.000Z", "indexedAt": null}비공개 또는 로컬 호스트에 있는 주소, 혹은 사용자 이름, 비밀번호, 포트가 들어간 주소는 422 invalid_knowledge_url입니다. 같은 수준의 같은 링크는 409 knowledge_link_exists입니다.
가져올 수 없는 페이지는 failure: "fetch_failed"와 함께 failed로 끝납니다. 한 페이지에서 최대 5MB를 읽습니다.