429 Too Many Requests
A demo was started too recently
- Code
demo_limit_reached- Status
429Too Many Requests- Type
https://errors.clavian.io/demo-limit-reached
What it means
Each person may start one demo window in a cool-down period, and the last one started inside it. The window is the only demo data Clavian keeps.
What to do
Say the demo has been used and when another can start: the Retry-After header, or the window’s nextStartAt from GET /v1/me/demo.
Example
The API answers with status 429 and this body, as application/problem+json. A detail may be added, saying what went wrong this time; it is for people, and changes.
{
"type": "https://errors.clavian.io/demo-limit-reached",
"title": "A demo was started too recently",
"status": 429,
"code": "demo_limit_reached",
"requestId": "req_01k5znw4hmfay8vvr14d2pf2db"
}
Endpoints that return it
From the OpenAPI document, every endpoint that names it among its answers:
POST /v1/me/demoStart your demo