---
title: "Request a job"
method: POST
path: "/jobs"
---

# Request a job

`POST /jobs`

Requests a job. This operation blocks until a job is available.

## Request body

- object
  - `types` string[], required

## Response `201`

Created

- object
  - `id` string, uuid, required
  - `location` string, required
  - `artifact_location` string
  - `type` 'osbuild', required
  - `args` unknown

## Other responses

- `4XX`
- `5XX`

## Changes

- **2020-09-20** `a760080732b8` — 1 breaking
  - added the new required request property `types`
- **2020-09-20** `a63540039a56` — 1 breaking, 1 warning, 2 info
  - removed the required property `manifest` from the response with the `201` status
  - removed the optional property `targets` from the response with the `201` status
  - added the optional property `args` to the response with the `201` status
  - added the required property `type` to the response with the `201` status
- **2020-09-08** `a86f016750cf` — 1 info
  - added the required property `id` to the response with the `201` status
- **2020-09-08** `1e48e6ecbc46` — 1 breaking, 2 info
  - removed the required property `token` from the response with the `201` status
  - added the optional property `artifact_location` to the response with the `201` status
  - added the required property `location` to the response with the `201` status
- **2020-09-07** `1ffa8032ea19` — 1 breaking, 2 info
  - removed the success response with the status `200`
  - api operation id `PostJob` removed and replaced with `RequestJob`
  - added the success response with the status `201`

[Full history](https://skmtc.dev/osbuild/apis/osbuild-composer-worker/changes/jobs/post.md)

---

[API](https://skmtc.dev/osbuild/apis/osbuild-composer-worker.md) · [All operations](https://skmtc.dev/osbuild/apis/osbuild-composer-worker/llms.txt) · [OpenAPI document](https://skmtc.dev/osbuild/apis/osbuild-composer-worker/revisions/a760080732b8?raw)