Plans, usage, and rate limits
Understand access requirements and shared API limits.
Plan requirement
REST and MCP require Creator or above. An ineligible workspace returns 403 PLAN_REQUIRED. Your current workspace role and permissions still apply on a paid plan.
Rate limits
REST keys and MCP tokens each allow 30 requests per minute with a 60-second fixed window. Exceeding that rate returns 429 RATE_LIMITED. Space requests and status polling, then retry after the window has room; do not immediately loop on a 429 response.
Organization usage
API/MCP usage is counted at the organization level. The monthly allowance depends on the plan and billing cycle; review API usage in Posteady settings. A request that exceeds an enforced monthly allowance returns 429 QUOTA_EXCEEDED. It resets at the next billing cycle, rather than after the one-minute rate-limit window.
The same error code can also indicate media storage exhaustion. Read the error message to distinguish request usage from storage. Reserved upload bytes count toward storage even before upload confirmation. Replays and polling are still requests and can contribute to usage.
Per-request limits
| Resource | Limit |
|---|---|
| Text publish/schedule | 1–5 accounts; 1–25 posts for Threads/X, one for LinkedIn |
| TikTok/Instagram/YouTube/Facebook publish/schedule | Exactly one account |
| Repost | One supported account and one native post ID |
| Schedules | Future timestamp within 360 days |
| Published posts | Fixed last 90 days; limit 1–100, default 20 |
| Media list | limit 1–100, default 20; offset 0–10,000 |
| JPEG upload | 8 MiB |
| MP4/QuickTime upload | 2 GiB in the shared library |
| Upload URL | PUT within 300 seconds |
| Upload confirmation | Within 24 hours of reservation |
Platform-specific character, duration, and file-size limits are documented in the platform guides. Uploading to the shared library does not guarantee acceptance by a platform. For example, YouTube publishing accepts at most 500 MiB, while Instagram and Facebook accept at most 1 GiB videos.
Platform allowances
The social platform can apply an additional publishing or upload allowance. Instagram checks can cause an asynchronous job to fail; YouTube daily upload or rate-limit failures can use PUBLISH_QUOTA_EXCEEDED. Inspect the job error in addition to the HTTP response. See Publishing lifecycle.
Blocked accounts
Blocked users receive 403 BLOCKED. See Errors and partial failures for the common response format and recovery steps.