FAQ & troubleshooting
General
Section titled “General”Can my AI tool publish or share a report?
Section titled “Can my AI tool publish or share a report?”No. AI connections can create drafts, upload versions and submit them for review. A publisher publishes and shares in the app. Tell your AI tool to finish with “your draft is ready to review”.
Which formats are supported?
Section titled “Which formats are supported?”HTML, PDF and Markdown, up to 25 MB per version. See Artifacts & versions.
Can I change an artifact’s format?
Section titled “Can I change an artifact’s format?”No. The format is fixed when the artifact is created. Create a new artifact for a different format.
Do clients need an account?
Section titled “Do clients need an account?”No. Recipients open their personal share link; no sign-in is needed.
What happens to links when I publish a new version?
Section titled “What happens to links when I publish a new version?”Every live link shows the new version immediately.
Can I edit a version?
Section titled “Can I edit a version?”No — versions are immutable. Upload a new version instead.
Can one AI connection work in several agencies?
Section titled “Can one AI connection work in several agencies?”No. Each connection works in one agency. Connect again (or approve again for another agency) to switch, or make separate connections.
Connecting
Section titled “Connecting”My AI tool can’t connect
Section titled “My AI tool can’t connect”- Check the endpoint is exactly
https://app.snowdots.com/mcp/snowdots. - For tokens, send
Authorization: Bearer <token>and check the token hasn’t expired (24 hours) or been revoked under AI connections. - Call
whoamito confirm the account, agency and permissions.
A tool is missing, or says it needs a permission
Section titled “A tool is missing, or says it needs a permission”Tools the connection has no permission for are hidden from the tool list. The connection wasn’t granted that scope. Create a new token, or reconnect and tick the permission. See Permissions.
“Your role … cannot create or edit clients”
Section titled ““Your role … cannot create or edit clients””Client tools need an owner, admin or publisher, even with clients:write.
“Your access to this client lets you read but not push versions”
Section titled ““Your access to this client lets you read but not push versions””You have View access on that client. Ask an admin for Contribute.
“No artifact with that id exists in your workspace”
Section titled ““No artifact with that id exists in your workspace””The id is wrong, belongs to another agency, or is out of your reach. Call list_artifacts.
Uploading
Section titled “Uploading”“The uploaded file is missing”
Section titled ““The uploaded file is missing””finalize_upload was called before the PUT finished. PUT the bytes to the upload URL, then finalize again.
“This upload has expired”
Section titled ““This upload has expired””Upload URLs last 15 minutes. Call create_upload again.
“The uploaded file size does not match the declared size”
Section titled ““The uploaded file size does not match the declared size””byte_size must be the exact number of bytes. Reserve a new upload with the right size.
“The declared MIME type does not match the file extension”
Section titled ““The declared MIME type does not match the file extension””Use a matching pair, for example report.pdf with application/pdf. See Upload rules.
“The content is … bytes, over the … byte limit for submit_content”
Section titled ““The content is … bytes, over the … byte limit for submit_content””submit_content takes up to 256 KB. Use create_upload for larger files.
My HTML report is missing images, fonts or charts
Section titled “My HTML report is missing images, fonts or charts”External requests are blocked. Inline everything: CSS and JavaScript in the page, images and fonts as data: URIs.
Review
Section titled “Review”“Only a draft can be submitted for review”
Section titled ““Only a draft can be submitted for review””An artifact already in review or published can’t be submitted again. Check with get_publish_status.
My draft came back
Section titled “My draft came back”A publisher returned it with a note. Read it with get_publish_status, upload a new version and submit again.