---
title: "Create a new job definition"
method: POST
path: "/job_definitions"
---

# Create a new job definition

`POST /job_definitions`

## Request body

- CreateJobDefinition
  - `input_uri` string
  - `input_filename` string
  - `runtime_environment_name` string
  - `runtime_environment_parameters` object
  - `output_formats` string[]
  - `parameters` object
  - `tags` string[]
  - `name` string
  - `output_filename_template` string
  - `active` boolean
  - `schedule` string
  - `timezone` string
  - `compute_type` string
  - `package_input_folder` boolean

## Response `200`

Successfully created the job definition.

- object
  - `job_definition_id` string

## Other responses

- `500` — Server error

---

[API](https://skmtc.net/jupyter-server/apis/jupyter-scheduler-api.md) · [All operations](https://skmtc.net/jupyter-server/apis/jupyter-scheduler-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jupyter-server/jupyter-scheduler-api/versions/f49a837fc1f2/schema)