Rate Limits - SimpleHost

Rate Limit Headers

Every API response includes rate limit information:

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed per hour
`X-RateLimit-Remaining`	Requests remaining in the current window
`X-RateLimit-Reset`	Unix timestamp when the window resets

The rate limit window is 1 hour, aligned to the top of the hour.

You’ll receive a 429 response:

{
  "error": "Rate limit exceeded. Try again later.",
  "code": "RATE_LIMITED",
  "status": 429
}

Check the X-RateLimit-Reset header for when you can retry.

File upload endpoints (PUT /api/v1/_upload/*) are not rate limited. They are already gated by upload tokens and expiry timestamps.

If you’re hitting rate limits on the Free plan, consider upgrading to Hobby ($5/mo) for 200 requests per hour — more than enough for most workflows.

Batch your operations where possible
Use hash deduplication to reduce the number of API calls when updating sites
The publish script handles everything in a single create → upload → finalize flow