Rate limits
To keep the service responsive for everyone, each action is capped per
rolling window. Hit a cap and the API returns 429 with a Retry-After; just wait it out. Admins and the bot are exempt.
These are the live values, straight from the backend.
| Action | Limit | Scope |
|---|---|---|
Upload a skin Uploading a new .osk to your collection. | 3 per hour | per user |
Save edits Saving changes to your skins (names, descriptions, tags, order, deletes). | 10 per hour | per user |
Trigger a build Manually dispatching a CI render of your skins. | 5 per hour | per user |
List builds Listing recent CI runs. | 60 per minute | per user / IP |
Read build logs Fetching a CI run's log. | 60 per minute | per user / IP |
Live build stream Opening a live (SSE) stream of a running build. | 10 per minute | per user / IP |
Open a profile Loading a member's skin page. | 60 per minute | per user / IP |
Community list Loading the community roster. | 30 per minute | per IP |
Avatars Fetching member avatars. | 120 per minute | per IP |
Your own media Images and .osk files from your own repo. | 200 per minute | owner |
Others' media Images and .osk files from anyone else's repo. | 60 per minute | per user / IP |
Download all Zipping and downloading every .osk in a collection at once. | 5 per hour | per user |
"per user" limits track your logged-in account; "per IP" track your network address. When signed in, you can check your own remaining budget via the API.