#Content
text too longuser-errorPost text exceeds Bluesky's character limit (300 characters).
Solution:
Bluesky has a 300-character limit per post. Shorten your text or split it into multiple posts (a thread). Be concise and to the point.
Comprehensive reference for Bluesky API errors. Find solutions and troubleshoot common integration issues.
3 errors
2 errors
2 errors
2 errors
1 error
invalid tokenrefresh-tokenBluesky session has expired. Please reconnect your Bluesky account.
Solution:
Your Bluesky session is no longer valid. Bluesky uses session-based authentication. Reconnect your account to establish a new session.
expiredrefresh-tokenBluesky session has expired. Please reconnect your Bluesky account.
Solution:
Your Bluesky session expired. Sessions typically last for a limited time. Reconnect your account to get a fresh session token.
unauthorizedrefresh-tokenBluesky session has expired. Please reconnect your Bluesky account.
Solution:
Authentication failed. This happens when your session expires or is invalid. Go to account settings and reconnect your Bluesky account.
rate limitretryBluesky rate limit reached. Please try again in a few moments.
Solution:
You've exceeded Bluesky's rate limits. Wait a few minutes before retrying. Bluesky enforces rate limits to maintain service quality.
too many requestsretryBluesky rate limit reached. Please try again in a few moments.
Solution:
Too many requests in a short time. Space out your requests and implement exponential backoff. The system will automatically retry.
blockeduser-errorContent blocked by Bluesky moderation. Please review Bluesky's community guidelines.
Solution:
Your content was blocked by Bluesky's moderation system. Review Bluesky's community guidelines and ensure your content complies with their policies.
moderationuser-errorContent blocked by Bluesky moderation. Please review Bluesky's community guidelines.
Solution:
Content flagged by moderation filters. Avoid posting spam, harassment, or content that violates Bluesky's guidelines. Review and modify your content.
blob too largeuser-errorMedia file is too large or invalid. Bluesky has strict file size limits.
Solution:
Bluesky has a maximum file size of 1MB for images. Compress your images to meet this requirement. Use tools like TinyPNG or ImageOptim.
blob invaliduser-errorMedia file is too large or invalid. Bluesky has strict file size limits.
Solution:
Your media file is invalid or corrupted. Ensure your image is a valid JPG, PNG, or WebP file. Re-export the image and try again.
text too longuser-errorPost text exceeds Bluesky's character limit (300 characters).
Solution:
Bluesky has a 300-character limit per post. Shorten your text or split it into multiple posts (a thread). Be concise and to the point.
Our API handles session management, file compression, and automatic retries.