---
title: "Create new `Job`"
method: POST
path: "/v1/jobs"
tags: ["not_implemented"]
---

# Create new \`Job\`

`POST /v1/jobs`

Create new `Job`

## Request body

- JobInput — Input to create a Job
  - `uploadSize` integer — Total size of the upload
  - `uploadId` string — ID of an Upload object to associate with the job
  - `uploadFiles` object — Key/value pairs of upload files and their md5s
  - `softwarePackageIds` string[] — List of software package object IDs for the job to use
  - `scoutFrames` string — Frames which should be executed first (all other frames will wait for the user to enqueue)
  - `project` string — Name of the project this job belongs to
  - `priority` integer — Priority of this job (0-999)
  - `padding` integer — Amount of padding for frame numbers
  - `owner` string — Owner of the job
  - `outputPath` string — Output directory on the user's system for generated artifacts
  - `notify` object — Dictionary of emails/slack ids to notify on job completion
  - `metadataId` string — ID of a Metadata object to attach to a job
  - `metadata` object — Metadata key/value pairs to tag job with
  - `machineFlavor` string — Flavor of instance to execute on ("standard", "highmem", "highcpu")
  - `location` string — Location for upload/download steering
  - `localUpload` string — Whether the job dependencies will be uploaded locally or not
  - `jobTitle` string — UI display title for the job
  - `frameRange` string — List of frames to execute
  - `environment` object — Environment variable key/value pairs for the execution environment
  - `cores` integer — Number of cores the executing instance should have
  - `command` string — Command to run
  - `chunkSize` integer — Number of frames per task

## Response `200`

Successful response

## Other responses

- `400` — Invalid input

---

[API](https://skmtc.dev/conductortech/apis/conductor-cloud-rendering-api.md) · [All operations](https://skmtc.dev/conductortech/apis/conductor-cloud-rendering-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductortech/conductor-cloud-rendering-api/revisions/0fb056b8d2a1/schema)