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

# Create a new job

`POST /jobs`

## Request

- Base URL: `/scheduler` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/scheduler/jobs`
- Auth: one of:
  - API key in header `Authorization`
  - API key in query parameter `token`

## Request body

- CreateJob
  - `input_uri` string
  - `input_filename` string
  - `runtime_environment_name` string
  - `runtime_environment_parameters` object
  - `additionalProperties` string
  - `output_formats` string[]
  - `parameters` object
  - `tags` string[]
  - `name` string
  - `output_filename_template` string
  - `compute_type` string
  - `package_input_folder` boolean

## Response `200`

Successfully created the job.

- object
  - `job_id` string

## Other responses

- `500`: Server error

---

[API](https://skmtc.dev/jupyter-server/apis/jupyter-scheduler-api.md) - [All operations](https://skmtc.dev/jupyter-server/apis/jupyter-scheduler-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jupyter-server/apis/jupyter-scheduler-api/revisions/f49a837fc1f2?raw)