---
title: "Function Schedule Set"
method: POST
path: "/functions/{function_id}/schedule"
tags: ["functions"]
---

# Function Schedule Set

`POST /functions/{function_id}/schedule`

## Path parameters

- `function_id` string, required

## Headers

- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Request body

- FunctionScheduleCreateRequest
  - `cron` string, required — AWS EventBridge schedule expression. Six space-separated fields, minutes first: `minutes hours day-of-month month day-of-week year`. This is neither five-field Unix crontab nor the seconds-first six-field dialect used by Quartz and cron-parser. Exactly one of day-of-month and day-of-week must be `?`, the other must be a real value. Schedules fire in UTC. Example: `0 12 ? * * *` runs daily at noon UTC. `rate(...)` expressions such as `rate(1 hour)` are accepted too.
  - `variables` object, nullable, required — Values passed to the function on every scheduled run. Must supply every function variable that has no default, and no names the function does not declare.

## Response `200`

Successful Response

- ScheduleResponse
  - `status` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/notte/apis/notte-api.md) · [All operations](https://skmtc.dev/notte/apis/notte-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/notte/notte-api/revisions/442ff5940528/schema)