Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rheos.app/llms.txt

Use this file to discover all available pages before exploring further.

Most publishing failures come down to one of three things: an expired token, a content rule a platform enforces, or a permissions gap. Here’s how to spot and fix each.

​
A post failed to publish

When a scheduled post fails, it stays in your queue with a red status and an error message. Open the post to see which platform failed and why — other platforms in the same post will still have gone out.
1

Open the failed post

Click it in the calendar or posts list. You’ll see a status per network.
2

Read the error

Hover the failed network to see the platform’s exact message.
3

Fix and retry

Either reconnect the account, edit the content, or remove the failing platform — then click Retry publish.

​
Common errors

The platform invalidated your access. Go to Settings → Social accounts and click Reconnect next to the affected network. Then retry the post.Rheos auto-refreshes tokens where the platform allows it, but some (TikTok, X) need a manual reconnect every few months.
Your Instagram account needs to be Business or Creator (not personal) to publish via the API. Switch it in the Instagram app under Settings → Account type, then reconnect in Rheos.
If we’ve recently added new features (e.g. company mentions), you may need to reconnect to grant the extra scopes. Disconnect and reconnect from Settings → Social accounts.
Each network has its own rules — TikTok and Instagram Reels need vertical (9:16) video; X caps video at 2 minutes 20 seconds; carousels are capped at 10 slides on Instagram. Swap or re-encode the media and retry.
You’ve hit a platform’s posting cap (most enforce per-hour or per-day limits). Wait an hour and retry, or reschedule for later.
X and LinkedIn block exact-duplicate posts within a short window. Tweak the copy slightly and retry.

​
Still stuck?

Email support@rheos.app with the post title, the platform that failed, and the error message. We can usually diagnose within a few hours.
Last modified on May 15, 2026