If you want to delay a video becoming available to watch (such as early in the morning or late at night), you can set a scheduled time for it.

The video will still be processed and assigned a unique ID. However only members of your team who are signed in to the dashboard will be able to access it. That allows them to manage it (check it, replace its thumbnail, and so on). However its share link and embed code won’t load for anonymous viewers until the chosen time has passed.

You can set a scheduled time using our dashboard or video API:


Upload a video as normal, then expand the options. You should see an option to set a release time. Either type in a date (such as 05/02/2023, 02:00) or click on the small icon of a calendar and choose a time within that panel:

Scheduled time


The POST /videos endpoint is used to add a new video. Send the input (where we can fetch the video from), name, and an additional parameter called scheduled_time. That should be an ISO 8601 UTC date/time. We recommend a time at least an hour ahead of your current time. For example:

curl \
-g \
-H "Authorization: Bearer YOUR-API-KEY" \
-H "Content-Type: application/json" \
-d '{"input":"https://example.com/test.mp4", "name":"Test", "scheduled_time":"2023-02-05T02:00:00.000Z"}' \

We recommend trying it out on a test video first to confirm that it works how you expect.

Go back