---
title: "Create a new job"
method: POST
path: "/v1/apps/{app_id}/jobs"
tags: ["jobs"]
---

# Create a new job

`POST /v1/apps/{app_id}/jobs`

## Path parameters

- `app_id` string, required

## Query parameters

- `onboarding` integer

## Headers

- `X-Fields` string, mask

## Request body

- JobInput
  - `callbackUrl` string
  - `inputs` object[]
  - `inputsFileUrl` string
  - `inputsDataUrl` string
  - `metadata` object
  - `tags` string[]
  - `accept_measurement_jobs` boolean
  - `pending` boolean
  - `labeler` 'owner' | 'ai' | 'bots' | 'crowd'
  - `no_strict` boolean
  - `outputs` object[]

## Response `201`

Jobs Submitted

- JobSubmitted
  - `message` string
  - `uuid` string
  - `truncated_inputs` boolean
  - `batch_id` string

## Other responses

- `400` — Invalid onboarding code
- `401` — Invalid API-KEY
- `402` — Upadate payment
- `409` — User must accept MeasurementJobs or User has not selected metrics or performance is being calculated
- `500` — Job could not be submitted

---

[API](https://skmtc.net/super/apis/super-ai-api.md) · [All operations](https://skmtc.net/super/apis/super-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/super/super-ai-api/revisions/d2c17db7266d/schema)