LogoFreestyle

Serverless Deployments CLI

Use the CLI to create deployments from inline code, a file, or a repo.

Prerequisites

  • Set FREESTYLE_API_KEY in your environment.
  • Run commands as npx freestyle ....

Create a deployment

You must provide exactly one of --code, --file, or --repo.

From inline code

npx freestyle deploy --code 'export default () => new Response("ok")'

From a file

npx freestyle deploy --file ./entry.ts

From a repo

npx freestyle deploy --repo <repo-id-or-url>

Pass environment variables

Repeat --env for multiple values.

npx freestyle deploy \
  --file ./entry.ts \
  --env NODE_ENV=production \
  --env API_BASE_URL=https://api.example.com

JSON output

npx freestyle deploy --file ./entry.ts --json

Cron jobs

Create a schedule:

npx freestyle cron schedule \
  --deployment-id <deployment-id> \
  --cron '*/5 * * * *' \
  --timezone UTC

List schedules:

npx freestyle cron list --deployment-id <deployment-id>

List executions:

npx freestyle cron executions <schedule-id> --limit 20

Disable/enable schedule:

npx freestyle cron disable <schedule-id>
npx freestyle cron enable <schedule-id>

Get success rate over a time range:

npx freestyle cron success-rate <schedule-id> \
  --start 2026-02-14T00:00:00.000Z \
  --end 2026-02-14T23:59:59.999Z

For a full cron workflow, see Cron Jobs.

Notes

On this page

Freestyle AI

Documentation assistant

Experimental: AI responses may not always be accurate—please verify important details with the official documentation.

How can I help?

Ask me about Freestyle while you browse the docs.