Set by the platform. The Apps list shows it with how many you have, such as 3 of 20 apps. Through the API, limits.apps in the answer to GET /api/v1/client/apps/regions gives it, where 0 means no limit, and limits.apps_used how many you have (Regions, sizes and limits). A deleted app does not count.
3–63 lowercase letters, digits and hyphens, starting and ending with a letter or a digit, with no hyphens in both the third and fourth places. Unique on the platform, and not a reserved word (Names on the platform).
Repository address
An https:// address on a public host, up to 500 characters, with no user name, token, query or fragment.
Branch
A name git accepts, up to 200 characters.
Directory
A path inside the repository, up to 255 characters.
Access token
Up to 1000 characters.
Image reference
Up to 500 characters, on a public registry. It cannot be in the platform's own registry.
Install, build and start commands
Up to 500 characters each, on one line.
Dockerfile path
A path inside the repository, up to 255 characters.
Framework
Up to 32 lowercase letters, digits, dots, plus signs and hyphens, starting with a letter or a digit.
We count these requests over a rolling window. A request over a limit fails, and does not count towards it.
Requests
Most per window
Window
Counted for
Creating apps
20
1 hour
Your account, or the organization
Changes: every request that creates, changes, deploys or deletes
120
1 hour
Each person
Deployments: deploy, redeploy and roll back
30
10 minutes
Each app
Domain checks
30
10 minutes
Each app
Pushes that deploy
30
5 minutes
Each app
A request over a limit answers 429, with the length of the window in retry_after_seconds and in the Retry-After header:
JSON
{
"detail": {
"error": "rate_limited",
"message": "Too many deployments of this app. Wait a few minutes.",
"retry_after_seconds": 600
}
}
The push webhook answers 429 in its own shape (The webhook's answers). Every API request also counts towards the limits for your account as a whole, which Rate limits describes.
