\n \n \n\n \n

delay.val.run

Schedule HTTP requests to be executed in the future

POST https://delay.val.run

\n\n \n

How It Works

Send a POST request

Include the target URL, timing (delay or specific time), and optional request config

We store and schedule it

Your request is saved and queued for execution at the specified time

Request fires automatically

When the time comes, we send the HTTP request to your target URL

\n\n \n

Quick Start

\n \n

Using the TypeScript Client

import { delay } from \"https://esm.town/v/std/delay/client.ts\";\n\n// Delay by 5 minutes\nawait delay.schedule({\n  url: \"https://myapp.com/webhook\",\n  delaySeconds: 300,\n});\n\n// Or schedule for a specific time\nawait delay.schedule({\n  url: \"https://myapp.com/webhook\",\n  method: \"POST\",\n  headers: { \"Authorization\": \"Bearer token\" },\n  body: { orderId: 123 },\n  executeAt: \"2024-12-25T10:00:00Z\",\n});

\n\n

Using fetch directly

await fetch(\"https://delay.val.run\", {\n  method: \"POST\",\n  headers: { \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({\n    url: \"https://myapp.com/webhook\",\n    delaySeconds: 300,\n  }),\n});

\n\n

Using cURL

curl -X POST https://delay.val.run \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"url\": \"https://myapp.com/webhook\", \"delaySeconds\": 300}'

\n\n \n

API Reference

Send a POST request to https://delay.val.run with a JSON body:

\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

Field	Type	Required	Description
`url`	string	Yes	Target URL to send the request to
`method`	string	No	HTTP method (default: \"POST\")
`headers`	object	No	Headers to include in the request
`body`	any	No	Request body (JSON or string)
`delaySeconds`	number	*	Seconds to delay before executing
`executeAt`	string	*	ISO 8601 timestamp to execute at

* Either delaySeconds or executeAt is required (not both)

\n\n

Response

{\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"scheduledFor\": \"2024-01-15T10:05:00.000Z\",\n  \"status\": \"scheduled\"\n}

\n\n \n

Use Cases

⏰ Delayed Webhooks

Send a notification after a cooldown period

📧 Reminder Systems

Trigger follow-up emails at specific times

🔄 Retry Logic

Schedule a retry attempt after a delay

📅 Scheduled Tasks

Execute API calls at future dates

\n\n \n

Limitations

\n ⚡\n ~1 minute precision: Requests are processed every minute, so execution may be up to 60 seconds after the scheduled time\n

\n 🔁\n No retries: If a request fails, it will not be automatically retried\n

\n ❌\n No cancellation: Once scheduled, requests cannot be cancelled\n

\n 🔓\n No authentication: This is an open service with no API keys\n

\n 🧪\n Experimental: This service may change or become unavailable without notice\n

\n\n \n \n

\n\n\n",[146],"472471ac-e80f-11f0-89da-42dde27851f2","client.ts","4724726a-e80f-11f0-89da-42dde27851f2",7,["D",1767381276416],"/**\n * Val Town Delay Service Client\n * \n * Schedule HTTP requests to be executed in the future.\n * \n * @example\n * ```ts\n * import { delay } from \"https://esm.town/v/std/delay/client.ts\";\n * \n * // Delay by seconds\n * await delay.schedule({\n * url: \"https://myapp.com/webhook\",\n * delaySeconds: 300,\n * });\n * \n * // Schedule for a specific time\n * await delay.schedule({\n * url: \"https://myapp.com/webhook\",\n * executeAt: \"2024-12-25T10:00:00Z\",\n * });\n * ```\n */\n\nconst DELAY_SERVICE_URL = \"https://delay.val.run\";\n\nexport interface ScheduleOptions {\n /** The URL to send the request to */\n url: string;\n /** HTTP method (default: \"POST\") */\n method?: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\" | string;\n /** Headers to include in the request */\n headers?: Record;\n /** Request body (will be JSON stringified if object) */\n body?: unknown;\n /** Number of seconds to delay the request */\n delaySeconds?: number;\n /** ISO 8601 timestamp to execute the request at */\n executeAt?: string | Date;\n}\n\nexport interface ScheduleResult {\n /** Unique identifier for the scheduled request */\n id: string;\n /** ISO 8601 timestamp when the request will be executed */\n scheduledFor: string;\n /** Status of the scheduled request */\n status: \"scheduled\";\n}\n\nexport interface DelayError extends Error {\n statusCode: number;\n response: unknown;\n}\n\n/**\n * Schedule an HTTP request to be executed in the future.\n * \n * @param options - The scheduling options\n * @returns Promise resolving to the schedule result\n * @throws {DelayError} If the request fails\n * \n * @example\n * ```ts\n * // Simple delay\n * const result = await schedule({\n * url: \"https://api.example.com/callback\",\n * delaySeconds: 60,\n * });\n * console.log(`Scheduled for: ${result.scheduledFor}`);\n * ```\n */\nexport async function schedule(options: ScheduleOptions): Promise {\n // Convert Date to ISO string if needed\n const executeAt = options.executeAt instanceof Date \n ? options.executeAt.toISOString() \n : options.executeAt;\n\n const response = await fetch(DELAY_SERVICE_URL, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n url: options.url,\n method: options.method,\n headers: options.headers,\n body: options.body,\n delaySeconds: options.delaySeconds,\n executeAt,\n }),\n });\n\n const data = await response.json();\n\n if (!response.ok) {\n const error = new Error(data.error || \"Failed to schedule request\") as DelayError;\n error.statusCode = response.status;\n error.response = data;\n throw error;\n }\n\n return data as ScheduleResult;\n}\n\n/**\n * Schedule a request to be executed after a delay in seconds.\n * Convenience wrapper around `schedule()`.\n * \n * @param url - The URL to send the request to\n * @param delaySeconds - Number of seconds to delay\n * @param options - Additional request options\n * @returns Promise resolving to the schedule result\n * \n * @example\n * ```ts\n * await delayBy(\"https://api.example.com/callback\", 300);\n * ```\n */\nexport async function delayBy(\n url: string, \n delaySeconds: number, \n options?: Omit\n): Promise {\n return schedule({ ...options, url, delaySeconds });\n}\n\n/**\n * Schedule a request to be executed at a specific time.\n * Convenience wrapper around `schedule()`.\n * \n * @param url - The URL to send the request to\n * @param executeAt - When to execute (Date or ISO string)\n * @param options - Additional request options\n * @returns Promise resolving to the schedule result\n * \n * @example\n * ```ts\n * await delayUntil(\"https://api.example.com/callback\", new Date(\"2024-12-25T10:00:00Z\"));\n * ```\n */\nexport async function delayUntil(\n url: string, \n executeAt: Date | string, \n options?: Omit\n): Promise {\n return schedule({ ...options, url, executeAt });\n}\n\n// Default export for convenience\nexport const delay = {\n schedule,\n delayBy,\n delayUntil,\n};\n\nexport default delay;\n",[154],"7bc87502-e80f-11f0-bda8-42dde27851f2","README.md","7bc875b6-e80f-11f0-bda8-42dde27851f2",9,["D",1767381364732],"# delay.val.run\n\nSchedule HTTP requests to be executed in the future.\n\n> ⚠️ **Experimental Service**: This is a free, experimental service provided as-is with no guarantees. Use with caution.\n\n## Quick Start\n\n### Using the TypeScript Client\n\n```typescript\nimport { delay } from \"https://esm.town/v/std/delay/client.ts\";\n\n// Delay by 5 minutes\nawait delay.schedule({\n url: \"https://myapp.com/webhook\",\n delaySeconds: 300,\n});\n\n// Or schedule for a specific time\nawait delay.schedule({\n url: \"https://myapp.com/webhook\",\n method: \"POST\",\n headers: { \"Authorization\": \"Bearer token\" },\n body: { orderId: 123 },\n executeAt: \"2024-12-25T10:00:00Z\",\n});\n```\n\n### Using fetch\n\n```typescript\nawait fetch(\"https://delay.val.run\", {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n url: \"https://myapp.com/webhook\",\n delaySeconds: 300,\n }),\n});\n```\n\n### Using cURL\n\n```bash\ncurl -X POST https://delay.val.run \\\n -H \"Content-Type: application/json\" \\\n -d '{\"url\": \"https://myapp.com/webhook\", \"delaySeconds\": 300}'\n```\n\n## API Reference\n\n### POST https://delay.val.run\n\nSchedule a delayed HTTP request.\n\n#### Request Body\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `url` | string | Yes | Target URL to send the request to |\n| `method` | string | No | HTTP method (default: \"POST\") |\n| `headers` | object | No | Headers to include in the request |\n| `body` | any | No | Request body (JSON or string) |\n| `delaySeconds` | number | * | Seconds to delay before executing |\n| `executeAt` | string | * | ISO 8601 timestamp to execute at |\n\n\\* Either `delaySeconds` or `executeAt` is required (not both)\n\n#### Response\n\n```json\n{\n \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"scheduledFor\": \"2024-01-15T10:05:00.000Z\",\n \"status\": \"scheduled\"\n}\n```\n\n## Client Library\n\nThe TypeScript client provides a convenient wrapper around the API.\n\n### Installation\n\n```typescript\nimport { delay } from \"https://esm.town/v/std/delay/client.ts\";\n```\n\n### Methods\n\n#### `delay.schedule(options)`\n\nSchedule a request with full configuration options.\n\n```typescript\nconst result = await delay.schedule({\n url: \"https://api.example.com/webhook\",\n method: \"POST\",\n headers: { \"X-Custom-Header\": \"value\" },\n body: { data: \"payload\" },\n delaySeconds: 60,\n});\n```\n\n#### `delay.delayBy(url, seconds, options?)`\n\nConvenience method to schedule by delay duration.\n\n```typescript\nawait delay.delayBy(\"https://api.example.com/webhook\", 300);\n\n// With additional options\nawait delay.delayBy(\"https://api.example.com/webhook\", 300, {\n method: \"PUT\",\n body: { updated: true },\n});\n```\n\n#### `delay.delayUntil(url, time, options?)`\n\nConvenience method to schedule for a specific time.\n\n```typescript\nawait delay.delayUntil(\"https://api.example.com/webhook\", new Date(\"2024-12-25T10:00:00Z\"));\n\n// Or with an ISO string\nawait delay.delayUntil(\"https://api.example.com/webhook\", \"2024-12-25T10:00:00Z\");\n```\n\n## Limitations\n\n- **~1 minute precision**: Requests are processed every minute\n- **No retries**: Failed requests are not automatically retried\n- **No cancellation**: Scheduled requests cannot be cancelled\n- **No authentication**: This is an open service\n- **Experimental**: Service may change without notice\n\n## Use Cases\n\n- **Delayed webhooks**: Send notifications after a cooldown period\n- **Reminder systems**: Trigger follow-up actions at specific times\n- **Retry logic**: Schedule retry attempts after failures\n- **Scheduled tasks**: Execute API calls at future dates\n\n## License\n\nMIT\n",[161],"pulls","branches","forks","envVars",{"_174":42,"_176":42},"connections",{"_174":42,"_175":42},"count","unfilledCount","emptyCount",{"_18":160,"_20":161,"_114":162,"_116":-5,"_117":68,"_118":163,"_119":38,"_22":199,"_65":42,"_122":95,"_124":165,"_126":26,"_127":-5,"_184":200,"_85":201},{"_18":153,"_20":154,"_114":155,"_116":-5,"_117":68,"_118":156,"_119":38,"_22":196,"_65":42,"_122":134,"_124":158,"_126":26,"_127":-5,"_184":197,"_85":198},{"_18":145,"_20":146,"_114":147,"_116":-5,"_117":68,"_118":148,"_119":38,"_22":193,"_65":150,"_122":95,"_124":151,"_126":26,"_127":-5,"_184":194,"_85":195},{"_18":137,"_20":138,"_114":36,"_116":-5,"_117":68,"_118":139,"_119":38,"_22":190,"_65":141,"_122":142,"_124":143,"_126":26,"_127":21,"_184":191,"_85":192},{"_18":129,"_20":130,"_114":131,"_116":-5,"_117":68,"_118":132,"_119":38,"_22":187,"_65":42,"_122":134,"_124":135,"_126":26,"_127":-5,"_184":188,"_85":189},{"_18":112,"_20":113,"_114":115,"_116":-5,"_117":68,"_118":66,"_119":38,"_22":183,"_65":121,"_122":123,"_124":125,"_126":26,"_127":-5,"_184":185,"_85":186},["D",1768767819598],"children",[],[113],["D",1767381218094],[],[130],["D",1767381628815],[],[138],["D",1767381736409],[],[146],["D",1767381276416],[],[154],["D",1767381364732],[],[161],["D",1767380822867],{"_16":17,"_83":79},{"_16":17,"_77":-5,"_78":79,"_33":-5,"_80":81,"_82":26},{"_65":66,"_20":67,"_18":68,"_69":19,"_70":-5,"_71":-5,"_72":-5,"_73":-5,"_74":-5,"_75":21,"_76":17},"ctx",{"_58":-5,"_103":239,"_240":241,"_242":243,"_244":26,"_245":26,"_246":26,"_247":38,"_248":-5,"_249":-7,"_250":-7,"_251":42,"_252":26,"_253":26,"_254":-5,"_255":26,"_256":26,"_257":26,"_258":-5},"ENV",{"_210":211,"_212":213,"_214":67,"_215":216,"_217":218,"_219":220,"_221":222,"_223":224,"_225":226,"_227":228,"_229":230,"_231":232,"_233":234,"_235":236,"_237":238},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Search