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 50 requests per minute with a 60-second fixed window. Exceeding that rate returns 429 RATE_LIMITED. Space out requests and status polling, then retry once the window resets; 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. The allowance resets at the start of the next billing cycle, not 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 | Last 90 days by default; since–until up to 90 days; limit 1–100, default 20; offset 0–9,900 |
| Account analytics | Last 90 days by default; since–until up to 90 days |
| Comment reply | Text only; Instagram 2,200 characters, YouTube 10,000, Threads 500, X 280 or 25,000 for X Premium accounts (Korean, Chinese, Japanese characters and emoji count as 2), LinkedIn 1,250, Facebook 8,000; TikTok applies its own limit |
| Media list | limit 1–100, default 20; offset 0–10,000 |
| JPEG upload | 8 MiB |
| PNG/WebP upload | 20 MiB, stored as JPEG |
| MP4/QuickTime upload | 4 GiB in the shared library (over 2 GiB with uploadMethod: multipart) |
| 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 2 GiB, while Instagram and Facebook accept videos up to 1 GiB.
Platform allowances
Each social platform can also enforce its own publishing or upload limits. Instagram's checks can cause an asynchronous job to fail; YouTube daily upload or rate-limit failures can appear as 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.