---
title: "Create a job"
method: POST
path: "/api/jobs"
tags: ["Jobs"]
---

# Create a job

`POST /api/jobs`

Create a new job with optional scheduling and test configuration.

## Request body

- JobCreateRequest
  - `name` string, required
  - `description` string
  - `cronSchedule` string
  - `tests` JobTestRef[], required — Array of test references to include in this job
    - `id` string, uuid, required
  - `jobType` 'playwright' | 'k6'
  - `alertConfig` JobAlertConfig
    - `enabled` boolean
    - `notificationProviders` string[]
    - `alertOnFailure` boolean
    - `alertOnSuccess` boolean
    - `alertOnTimeout` boolean
    - `failureThreshold` integer
    - `recoveryThreshold` integer
    - `customMessage` string

## Response `200`

Job created

- JobCreateResponse
  - `success` boolean
  - `job` object
    - `id` string, uuid
    - `name` string
    - `description` string, nullable
    - `cronSchedule` string, nullable
    - `nextRunAt` string, date-time, nullable
    - `scheduledJobId` string, nullable
    - `jobType` 'playwright' | 'k6'

## Other responses

- `400` — Invalid job payload
- `401` — Authentication required or token invalid
- `402` — Active subscription required
- `403` — Insufficient permissions

## Changes

> 4 revisions in range; 1 could not be searched.

- **2026-03-21** `40aeed2ccba7` — 5 breaking, 3 warning, 6 info
  - added the new required request property `tests/items/id`
  - the request property `tests` became required
  - the `tests` request property's minItems was increased to `1`
  - the `tests/items/` request property type/format changed from `string`/`` to `object`/``
  - …10 more
- **2026-02-08** `78bbac89339b` — 2 breaking, 3 warning, 8 info
  - the `tests/items/` request property type/format changed from `object`/`` to `string`/``
  - removed the success response with the status `200`
  - removed the request property `alertConfig`
  - removed the request property `jobType`
  - …9 more

[Change history](https://skmtc.dev/supercheck-io/apis/supercheck-api/changes/api/jobs/post.md)

---

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