ClavianAPI errors
All error codes

429 Too Many Requests

A demo was started too recently

Code
demo_limit_reached
Status
429 Too 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: