---
title: "Create jobs schedule"
method: PUT
path: "/{env_id}/{flow_id}/{tenant_id}/jobs/schedule"
---

# Create jobs schedule

`PUT /{env_id}/{flow_id}/{tenant_id}/jobs/schedule`

## Request

- Base URL: `https://api.hotglue.com`
- URL: `https://api.hotglue.com/{env_id}/{flow_id}/{tenant_id}/jobs/schedule`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/hotglue/apis/hotglue-api/docs/:env_id/:flow_id/:tenant_id/jobs/schedule/put.ts> (a function with typed inputs; its response is checked against the schema)

Create a new schedule for a tenant

## Path parameters

- `env_id` string, required
- `flow_id` string, required
- `tenant_id` string, required

## Request body

- object
  - `job_type` 'read' | 'write': The type of job within the v2 flow to manipulate. Accepts "read" or "write."
  - `schedule_expression` string, required: cron expression defining how often sync should occur e.g. `cron(0 0 * * *)`
  - `state` 'DISABLED' | 'ENABLED': Whether this schedule should be DISABLED or ENABLED
  - `schedule_jitter_minutes` integer, nullable: Jitter window in minutes for default schedules. Only allowed when tenant is `default`; set to null to clear.

## Response `200`

200

- object
  - `ScheduleExpression` string
  - `State` string
  - `ScheduleJitterMinutes` integer, nullable

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/hotglue/apis/hotglue-api.md) - [All operations](https://skmtc.dev/hotglue/apis/hotglue-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hotglue/apis/hotglue-api/revisions/00870a66a550?raw)