range-too-short

• Status: 422 Unprocessable Entity
• Route: POST /api/v1/generate-events
• Description: range is too short for the event count: expected a longer range or fewer events
• Details: eventCount, from, and to, as the request gave them.

Why It Happens#

• Even the largest population that SynthEvents sizes, with as many members as events asked for, comes out at too few events in this range: in so short a range, hardly anybody does anything. Asking for 20,000 events of the to-dos within a single minute, for example, is refused this way.
• The run comes out at no events at all. An empty data set is never what anybody asks for, so it is refused, too.

How to Fix It#

Make the range longer, or ask for fewer events. For how SynthEvents sizes a run, see The Number of Events.

Example#

For 20,000 events of the to-dos within a single minute, SynthEvents answers:

{
  "type": "error",
  "data": {
    "code": "https://docs.synthevents.io/errors/range-too-short",
    "description": "range is too short for the event count: expected a longer range or fewer events",
    "details": {
      "eventCount": 20000,
      "from": "2025-01-01T00:00:00Z",
      "to": "2025-01-01T00:01:00Z"
    }
  }
}