Troubleshooting
Fixes for the most common snags. If none of these help, email us at hello@amendary.com.
I don't see a repo I expected to see.
Check that it was included when you installed the GitHub App. To adjust which repos it can see, use “Manage repos on GitHub” next to the account on the Repos tab; changes there sync back automatically. Also check you have not hit your plan’s repo limit on Settings > Plan & billing (limits are on the pricing page).
GitHub sent me to its settings page and Amendary did not connect.
That account or organisation already had Amendary installed, so GitHub showed its settings page instead of returning to Amendary. Select “Connect GitHub” on the Repos tab again: it lists the accounts and organisations where Amendary is installed, so you can pick that one.
A Notion page isn't showing up.
Amendary can only see pages you shared with the integration when you connected Notion, and Notion search is not exhaustive. If a page is missing from Browse on the Notion card, reconnect Notion and select it (or its parent) in Notion’s picker. Or open the … menu on the Notion card, select Add a page by link… and paste its link. Pages inside a database appear when you expand that database in Browse.
A page shows as gone from Notion.
The page was deleted or unshared in Notion, so Amendary can no longer read it and stops checking it. It is hidden from your watched list; you can show gone pages to review them. If it still exists, reconnect Notion and select it again; if it is really gone, you can remove it.
Zendesk or Intercom: an article shows as gone.
The article was deleted in Zendesk or Intercom, so Amendary stops checking it. Unwatch it, or restore it in the help center and select Browse again.
A Markdown page in GitHub isn't showing up.
On the Pages tab, confirm an owner enabled a GitHub docs destination for that repo and chose the correct folder or wiki. Select Refresh on its card to scan for Markdown files added since the last scan, then open Browse to watch the file. A discovered file is not checked until you watch it.
A card says Needs reconnecting.
Amendary can no longer use the sign-in, so it cannot read or fix those pages or articles. Select Reconnect on the card on the Pages tab, or on Settings > Integrations. Your watched pages and articles stay as they are.
A Zendesk sign-in renews on its own; you see this only when Zendesk refuses to renew it. An Intercom sign-in does not expire, so this usually means the Amendary app was removed in Intercom.
Zendesk or Intercom: “rejected the credentials” or “rejected the access token”.
Zendesk or Intercom refused the sign-in Amendary holds. Reconnect as above. If it keeps happening, disconnect the connection and add it again with Add destination.
Zendesk: “Enter the part before .zendesk.com”.
Amendary asks for your Zendesk subdomain only. For acme.zendesk.com, enter acme.
Intercom: “Intercom refused the connection”.
The most common cause is the wrong region. Amendary supports US, EU and Australia, and you pick one before you sign in. Check the address you use for Intercom:
app.intercom.com: USapp.eu.intercom.com: EUapp.au.intercom.com: Australia
Add Intercom again with Add destination and pick that region.
Zendesk or Intercom: there is no Browse button.
There is no Browse button until an owner sets Help articles follow on the card: a repo or a changelog URL. Then Browse lists the articles. See Help articles follow.
Intercom: an article is not in the list.
Amendary lists published Intercom articles only. A draft is not listed. Publish it in Intercom, then open Browse again. Zendesk is different: it lists drafts too, marked Draft.
Intercom: a missing language cannot be drafted.
Intercom needs more than one language turned on in its help center before it accepts a translation. Turn on the language in Intercom’s help center settings, then try again.
Zendesk or Intercom: “is rate limiting”.
The help center asked Amendary to slow down. Nothing was changed. Wait a minute and try again.
“The free trial includes 1 help center”, or another plan limit.
Each plan limits two things for help centers, and the free trial a third:
- Help centers. Setting Help articles follow on another destination adds a help center, and is refused at the limit.
- Articles, translations included. Each article counts once per language. Watching another article at the limit is refused, with how many you have and how many you tried to add. A translation past the limit shows “Over your plan’s article limit”. It is still listed, but fixes are not carried into it and a missing language cannot be drafted.
- Languages per help center (free trial only). A translation past the trial’s 2 languages shows “Over your plan’s language limit”, and gets no fixes either.
A limit never deletes anything. Settings > Plan & billing shows your usage. The limits per plan are on the pricing page. A team on its own Anthropic key has none of these limits.
My help-center pages never get checked.
A help center that follows a repo uses the repo’s What counts as shipped, and nothing may have shipped that way yet. The usual case: GitHub Releases is chosen but the repo has never published one, so there is nothing to check against. Open the Repos tab and look for the “Nothing has shipped this way yet” warning. Then either publish a release or push a tag, set the branch name, or switch to commits, which needs no setup. A help center that follows a changelog URL is checked only when a new dated entry appears; the destination’s card on the Pages tab shows when it was last read and what was skipped.
A mapped page is not checked.
On the Pages tab, look at the page’s audience. If it shows “Checks paused”, set an audience again to resume checks. Then look at the role of each repo on the page: a Background only repo starts no check unless Check when this repo changes too is ticked. Set the repo the page is about to Describes this repo.
The status says daily checks are paused until tomorrow.
Your team reached today’s usage limit. It is a safety cap set by Amendary, and checks resume at the next midnight in your team’s timezone (Settings > General). Settings > Usage shows your usage and the days checks were paused. If you hit it often, email us at hello@amendary.com.
I disconnected something by accident.
Nothing on GitHub, Notion, Zendesk or Intercom was changed. But Amendary deleted what it held for that connection: its corrections, check results and product-update entries. Reconnecting does not bring them back. Reconnect from the Repos tab, the Pages tab or Settings > Integrations, then check that your pages are still watched and mapped. A reconnected repo is checked from its latest commit on.
A docs-from-scratch run stopped or I cannot start it.
Open Generate docs, then History, and select the run to see its status and continue it. Check the credit estimate against your balance before starting. A restart on our side does not stop a run: it resumes on its own. If a run stops before producing drafts, its held credits are refunded; a run with drafts can be reviewed and resumed. Activity shows the reason a run stopped. See Billing & plans for how generation credits work.
Try Amendary on your own help center
Connect Notion, GitHub, Zendesk or Intercom and pick the articles to watch. Your first check shows what Amendary would fix, with the change as proof.
Free for 14 days with no card, and every edit waits for your review. Or free forever with your own Anthropic API key. Code is never touched.