Wait
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Viewing readonly version of main branch: v12View latest version
A simple API endpoint that waits for a specified duration and returns a success message.
Make a GET request to the endpoint with a duration query parameter:
GET /?duration=5000
duration(required): Duration to wait in milliseconds. Must be a non-negative number.
Success (200):
{ "success": true, "message": "Wait completed successfully", "requestedDuration": 5000, "actualDuration": 5001, "cappedAt": null }
Error (400):
{ "error": "Duration parameter is required. Provide duration in milliseconds as a query parameter." }
- Validates duration parameter (must be non-negative number)
- Caps duration at 60 seconds (Val Town free tier timeout limit)
- Pro accounts support up to 10 minutes
- Returns actual wait time for verification
- Indicates if duration was capped
- Free accounts: Maximum 60 seconds
- Pro accounts: Maximum 10 minutes (600 seconds)
This endpoint automatically caps the duration based on the free tier limit. For longer durations, upgrade to Pro.
# Wait for 2 seconds curl "https://your-val-url/?duration=2000" # Wait for 10 seconds curl "https://your-val-url/?duration=10000" # Error: missing duration curl "https://your-val-url/" # Error: invalid duration curl "https://your-val-url/?duration=invalid"