API
Read a knowledge item again
Fetches a link again, reads a file again or indexes a note again.
POST/knowledge/{id}/refresh
Runs the real call on your workspace.
POST /knowledge/{id}/refresh
Fetches a link again, reads a file again or indexes a note again.
Example
Needs knowledge:write. It clears a failure and puts the item back at queued. The previous text stays in use until the new one is ready.
curl -X POST "$OE/knowledge/kb_3e7b1d9a4c2f80e6b5a1c47d/refresh" -H "$AUTH"{ "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}Reading an item again twice leaves it the same way, so a retry is safe.