---
title: "Create a new scheduled job"
method: POST
path: "/scheduler/scheduled-jobs"
tags: ["Workspaces - Scheduler - Scheduled Jobs"]
---

# Create a new scheduled job

`POST /scheduler/scheduled-jobs`

## Request body

- ScheduledJob
  - `id` string
  - `userId` string
  - `projectId` string
  - `name` string, nullable
  - `task` unknown
  - `trigger` unknown
  - `created` string, date-time
  - `lastModified` string, date-time
  - `enabled` boolean
  - `nextRun` string, date-time
  - `running` boolean

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `429` — Too Many Requests

## Changes

- **2026-09-26** `65e661618b8f` — 1 info
  - api operation id `v` removed and replaced with `E`
- **2026-09-15** `4da8c9536717` — 1 info
  - api operation id `Q_2` removed and replaced with `v`
- **2026-09-15** `e2458537595b` — 1 info
  - api operation id `u_2` removed and replaced with `Q_2`
- **2026-09-11** `2e438cb3181d` — 1 info
  - api operation id `T` removed and replaced with `u_2`
- **2026-09-07** `50527361f800` — 1 info
  - api operation id `O_3` removed and replaced with `T`

[Full history](https://skmtc.dev/octoperf/apis/octoperf-api/changes/scheduler/scheduled-jobs/post.md)

---

[API](https://skmtc.dev/octoperf/apis/octoperf-api.md) · [All operations](https://skmtc.dev/octoperf/apis/octoperf-api/llms.txt) · [OpenAPI document](https://skmtc.dev/octoperf/apis/octoperf-api/revisions/65e661618b8f?raw)