Re-crawl one of the hub's websites
Re-crawls one of the hub's websites and regenerates the knowledge pages built from it (202). Pass a URL that is already one of the hub's websites — from websites[].url in the hub detail; the match ignores scheme and www., and a URL the hub does not have answers 404 KNOWLEDGE_HUB_WEBSITE_NOT_FOUND. Only the URL you pass is re-crawled: subpages the crawler already discovered from it are NOT re-crawled, and the pages built from them keep their existing text. When the website was added with includeSubPages, a refresh still picks up subpages that are new since the last crawl. To refresh a subpage, pass that subpage's own URL — every discovered subpage is itself one of the hub's websites. The hub flips to status processing at once; poll GET /business/knowledge-hubs/{hubId} until it is complete. The hub's owner can refresh, and so can anyone on the team when it is the team's shared hub, at most 3 times per minute and 25 per day on top of the shared rate bucket. Hubs built before knowledge pages cannot be refreshed (409 KNOWLEDGE_HUB_PAGES_UNAVAILABLE).
Errors:
- 404 KNOWLEDGE_HUB_NOT_FOUND — No hub with that id, it was deleted, or it belongs to another team.
- 404 KNOWLEDGE_HUB_WEBSITE_NOT_FOUND — url is not one of the hub's websites.
- 409 KNOWLEDGE_HUB_NOT_READY — The hub is still building, or is already processing another change.
- 409 KNOWLEDGE_HUB_PAGES_UNAVAILABLE — The hub predates knowledge pages and cannot be refreshed.
- 403 KNOWLEDGE_HUB_OWNER_ONLY — You can read this teammate's hub, but it is not your team's shared hub, so only its owner can refresh it.
- 422 VALIDATION_FAILED — url missing or outside 4-2048 characters.
- 500 UNEXPECTED_ERROR — The refresh workflow could not be enqueued; the hub is left complete — retry.
- 429 RATE_LIMITED — The shared campaigns bucket was exceeded, or more than 3 refreshes in a minute / 25 in a day.
Requires one of the following token scopes: campaigns.
Request
- Base URL: https://api.tryfuse.ai/api/v1
- URL: https://api.tryfuse.ai/api/v1/business/knowledge-hubs/{hubId}/refresh
- Auth: HTTP basic
Path parameters
24-character hex id of the knowledge hub (from GET /business/knowledge-hubs).
Request body
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.