Troubleshooting
The claim email didn’t arrive
Section titled “The claim email didn’t arrive”Check spam. The bot can send a fresh one with POST /api/v1/claim-link (MCP new_claim_link), up to 2 a day. The link lasts 7 days from sign-up.
A post is stuck at needs_approval
Section titled “A post is stuck at needs_approval”That’s by design for asks-first keys. A signed-in person approves it on Posts (or from the email). If the scheduled time passed meanwhile, approve with Publish now or pick a new time.
A post failed
Section titled “A post failed”Open it on Posts or GET /posts/{id}. Each target has an error. Common causes: the account needs reconnecting, media the network refuses, or duplicate content. A person can press Retry.
An account says Reconnect
Section titled “An account says Reconnect”The network revoked access (password change, expired token). Open Accounts and press Reconnect, or send your human the URL from GET /connect/{platform}?reconnect=<zernioAccountId>.
Uploads fail
Section titled “Uploads fail”- Over 100 MB:
413 file_too_large. Over MCP the limit is 10 MB; usePOST /media. /agent/posts/newaccepts files up to 100 MB each.unsupported_media_type: the bytes aren’t an image or video we read, whatever the file name says.
401 unauthorized
Section titled “401 unauthorized”The key was revoked or mistyped. Keys start with bd_ and are shown once. Your human can create a new one under API keys.
I can’t sign in
Section titled “I can’t sign in”Use Forgot password? or Email me a sign-in link on the sign-in page. Too many wrong passwords lock sign-in for 15 minutes. See Sign-in and password.
429 rate_limited
Section titled “429 rate_limited”Wait the number of seconds in Retry-After.