Troubleshooting
Fixes for the most common problems with Apifolio.
"The file … is no longer attached to this page." The attachment was renamed or deleted. Attach the file again with the same name, or edit the macro and pick the new file.
"This YAML file is not valid" with a line number. The spec has a syntax error. Open the file, go to the line shown and fix it (often a tab instead of spaces, or a missing quote). The preview in the macro configuration shows the error while you edit.
"This file is not an OpenAPI or Swagger document."
The file has no openapi or swagger field at the top. Check that you picked the right file.
"You don't have permission to see…" The spec is attached to another page you can't view. Ask the page owner for access, or attach a copy of the spec to this page.
The docs show an old version. Reload the page. Apifolio caches the parsed spec while the page is open, and always loads the latest attachment version on a fresh load.
Search in Confluence doesn't find new endpoints. Open the macro configuration and click Save to refresh the search digest.
The PDF shows only tables of endpoints. The API has more than 250 endpoints after filters. Narrow the macro to fewer sections. See Export.
Anonymous visitors see an error. The spec must be attached to the same page and be smaller than 4 MB. See Public spaces.
Still stuck? Write to [email protected] with the page link and a screenshot.