Help
How TidyKB works, written from the shipped product: connecting Freshdesk, what we read, the scan and score, bulk fixes and undo, translations, plans and limits.
Eight pages, written from the shipped product rather than from a plan. They are the reference for the parts that are easy to get wrong: what the connection test actually checks, which Freshdesk endpoints are called, how the health score is worked out, and what one-click undo can and cannot put back.
Start with connecting Freshdesk: creating a knowledge-base-only agent, pasting its API key, and reading each error the connection test can return. What TidyKB reads lists the exact endpoints, what is stored about your help center, what is sent to a translation model and how long any of it is kept. The scan and the health score explains the checks, and the cases where a scan refuses to claim that something is broken or fixed rather than guessing.
The rest is day-to-day work: ignoring an issue you will not fix, running a bulk find and replace with its read-only preview, its second Freshdesk key and its typed confirm, translation sync and your glossary, when scans and the weekly report run in your workspace time zone, and how articles and translation words are counted against your plan.
These pages are maintained with the product. Where one of them disagrees with what the app does, the app is right and the page is the bug.
- Connect Freshdesk with a KB-only agentCreate a knowledge-base-only agent in Freshdesk, paste its API key into TidyKB, and understand what the connection test checks and what each error means.Updated 22 September 2026
- What TidyKB reads, and what it never readsThe exact Freshdesk endpoints TidyKB calls, what it stores about your help center, what it sends to a translation model, and how long any of it is kept.Updated 22 September 2026
- The scan and the health scoreWhat a TidyKB scan checks, how the health score is worked out, and the cases where a scan deliberately refuses to claim that something is broken or fixed.Updated 22 September 2026
- Ignore an issue you won’t fixHow ignoring works in the TidyKB issue table: what it changes, what it does not change, how it survives a re-scan, and when to fix the cause instead.Updated 22 September 2026
- Find & replace: preview, confirm, undoHow a bulk find and replace runs: the read-only preview, the second Freshdesk key fixes need, the typed confirm, and what one-click undo can and cannot put back.Updated 22 September 2026
- Translation sync and your glossaryHow TidyKB finds translations that fell behind, drafts them with your glossary, checks them before you see them, and saves them into Freshdesk as drafts only.Updated 22 September 2026
- When scans run and the weekly reportSet your workspace time zone, choose the day and hour of the weekly report, and see exactly when a full scan, a daily top-up and a manual scan run.Updated 22 September 2026
- Billing, plans and limitsWhat each plan includes, how articles and translation words are counted, what happens when you hit a limit, and how Creem handles payment, VAT and invoices.Updated 22 September 2026