Skip to main content

Documentation Index

Fetch the complete documentation index at: https://upstash.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

context.sleep() pauses workflow execution for a specified duration. When a workflow is paused, the current request completes and a new one is automatically scheduled to resume after the delay. This ensures no compute resources are consumed during the sleep period.
Always await a sleep step to properly pause execution.

​
Arguments

​
stepName
string
A unique identifier for the step.
​
duration
number|string
The duration to pause workflow execution.
  • Human-readable string format:
InputDuration
"10s"10 seconds
"1m"1 minute
"30m"30 minutes
"2h"2 hours
"1d"1 day
"1w"1 week
"1mo"1 month
"1y"1 year
  • Numeric format (seconds):
InputDuration
6060 seconds (1 minute)
36003600 seconds (1 hour)
8640086400 seconds (1 day)

​
Usage

import { serve } from "@upstash/workflow/nextjs";
import { signIn, sendEmail } from "@/utils/onboarding-utils";

export const { POST } = serve<User>(async (context) => {
  const userData = context.requestPayload;

  const user = await context.run("sign-in", async () => {
    const signedInUser = await signIn(userData);
    return signedInUser;
  });

  // 👇 Wait for one day (in seconds)
  await context.sleep("wait-until-welcome-email", "1d");

  await context.run("send-welcome-email", async () => {
    return sendEmail(user.name, user.email);
  });
});