---
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

- Base URL: `https://api.octoperf.com`
- URL: `https://api.octoperf.com/scheduler/scheduled-jobs`
- Auth: none declared

## 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

- 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

## Other responses

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

## Changes

- **2026-11-03** `637a8f8ce8cf`: 1 info
  - api operation id `b_1` removed and replaced with `S_1`
- **2026-10-30** `fc0ab021d8d3`: 1 info
  - api operation id `a_2` removed and replaced with `b_1`
- **2026-10-29** `6fb7a9d5eb1c`: 1 info
  - api operation id `X_2` removed and replaced with `a_2`
- **2026-10-28** `6fc0f4ece308`: 1 info
  - api operation id `V_2` removed and replaced with `X_2`
- **2026-10-27** `d04c0ffc592f`: 1 info
  - api operation id `U` removed and replaced with `V_2`

[Operation 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/637a8f8ce8cf?raw)