---
title: "POST /jobs"
method: POST
path: "/jobs"
tags: ["jobs"]
---

# POST /jobs

`POST /jobs`

Create or updates a new job.

## Query parameters

- `runoncreate` string

## Request body

- Job — A Job represents a scheduled task to execute.
  - `name` string, required — Name for the job.
  - `displayname` string — Nice name for the job. Optional.
  - `schedule` string, required — Cron expression for the job.
  - `timezone` string — Timezone where the job will be executed. By default and when field is set to empty string, the job will run in local time.
  - `owner` string — Owner of the job
  - `owner_email` string — Email of the owner
  - `success_count` integer — Number of successful executions
  - `error_count` integer — Number of failed executions
  - `last_success` string, date-time — Last time this job executed successfully
  - `last_error` string, date-time — Last time this job failed
  - `disabled` boolean — Disabled state of the job
  - `tags` object — Target nodes tags of this job
  - `metadata` object — Extra metadata tags for this job
  - `retries` integer — Number of times to retry a failed job execution
  - `parent_job` string — The name/id of the job that will trigger the execution of this job
  - `dependent_jobs` string[] — Array containing the jobs that depends on this one
  - `processors` Processors — Processor plugins used to process executions results of this job
  - `concurrency` string — Concurrency policy for the job allow/forbid
  - `executor` string — Executor plugin used to run the job
  - `executor_config` object — Executor plugin parameters
  - `status` string — Status of the job

## Response `201`

Successful response

- Job — A Job represents a scheduled task to execute.
  - `name` string, required — Name for the job.
  - `displayname` string — Nice name for the job. Optional.
  - `schedule` string, required — Cron expression for the job.
  - `timezone` string — Timezone where the job will be executed. By default and when field is set to empty string, the job will run in local time.
  - `owner` string — Owner of the job
  - `owner_email` string — Email of the owner
  - `success_count` integer — Number of successful executions
  - `error_count` integer — Number of failed executions
  - `last_success` string, date-time — Last time this job executed successfully
  - `last_error` string, date-time — Last time this job failed
  - `disabled` boolean — Disabled state of the job
  - `tags` object — Target nodes tags of this job
  - `metadata` object — Extra metadata tags for this job
  - `retries` integer — Number of times to retry a failed job execution
  - `parent_job` string — The name/id of the job that will trigger the execution of this job
  - `dependent_jobs` string[] — Array containing the jobs that depends on this one
  - `processors` Processors — Processor plugins used to process executions results of this job
  - `concurrency` string — Concurrency policy for the job allow/forbid
  - `executor` string — Executor plugin used to run the job
  - `executor_config` object — Executor plugin parameters
  - `status` string — Status of the job

---

[API](https://skmtc.net/dkron-io/apis/dkron-rest-api.md) · [All operations](https://skmtc.net/dkron-io/apis/dkron-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dkron-io/dkron-rest-api/versions/4a08a6e9a7cd/schema)