Refresh API reference sources
URL and GitHub sources can refresh on their own or on demand; references sourced from an uploaded file cannot be refreshed, so upload a new file with Replace spec instead.
Refresh manually
Go to Help Center in the dashboard and click the API reference in the content tree.
Choose Refresh now (shown as Refresh from source in some views) on the reference.
Automatic refresh
URL sources are fetched automatically every six hours.
GitHub sources synchronize automatically when a push changes the spec file. The repository, the ref (branch or commit, defaulting to the repository's production branch), and the repository-relative file path must all match what is configured on the reference.
A GraphQL URL source must allow introspection unless the URL directly returns GraphQL SDL; otherwise the refresh produces no schema.
URL requirements
Specification URLs must use HTTP or HTTPS, must not include embedded credentials, and may follow at most five redirects.
URLs pointing at private or loopback hosts, including through a redirect, are blocked.
What's next
When a refresh fails, match the error message in Fix API reference source errors.