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

# Changes to Request a job

`POST /jobs`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 13 of 17 revisions.

- **2023-10-25** `6e568e568c76` — 1 info
- **2021-10-18** `33e0869b614b` — 1 info
- **2021-08-31** `6298f0b2bcb9` — 9 breaking, 3 warning, 3 info
- **2020-11-06** `94edd6bcee4e` — 1 info
- **2020-09-20** `85f1b1b3c2e3` — 1 breaking
- **2020-09-20** `a760080732b8` — 1 breaking
- **2020-09-20** `a63540039a56` — 1 breaking, 1 warning, 2 info
- **2020-09-08** `a86f016750cf` — 1 info
- **2020-09-08** `1e48e6ecbc46` — 1 breaking, 2 info
- **2020-09-07** `1ffa8032ea19` — 1 breaking, 2 info
- **2020-09-07** `dc3782214715` — 1 info
- **2020-09-07** `a58b3b1c70b6` — 1 info
- **2020-09-05** `87cae065c674` — 1 breaking

## Changes

- **2023-10-25** `6e568e568c76` — 1 info
  - added the new optional request property `worker_id`
- **2021-10-18** `33e0869b614b` — 1 info
  - added the success response with the status `204`
- **2021-08-31** `6298f0b2bcb9` — 9 breaking, 3 warning, 3 info
  - removed the enum value `osbuild` of the request property `types/items/`
  - the response's body type/format changed from `object`/`` to ``/`` for status `201`
  - the response's body type/format changed from `object`/`` to ``/`` for status `4XX`
  - the response's body type/format changed from `object`/`` to ``/`` for status `5XX`
  - removed the required property `id` from the response with the `201` status
  - removed the required property `location` from the response with the `201` status
  - removed the required property `message` from the response with the `4XX` status
  - removed the required property `message` from the response with the `5XX` status
  - removed the required property `type` from the response with the `201` status
  - removed the optional property `args` from the response with the `201` status
  - removed the optional property `artifact_location` from the response with the `201` status
  - removed the optional property `dynamic_args` from the response with the `201` status
  - added `#/components/schemas/ObjectReference, subschema #2` to the response body `allOf` list for the response status `201`
  - added `#/components/schemas/ObjectReference, subschema #2` to the response body `allOf` list for the response status `4XX`
  - added `#/components/schemas/ObjectReference, subschema #2` to the response body `allOf` list for the response status `5XX`
- **2020-11-06** `94edd6bcee4e` — 1 info
  - added the optional property `dynamic_args` to the response with the `201` status
- **2020-09-20** `85f1b1b3c2e3` — 1 breaking
  - added the new required request property `arch`
- **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`
- **2020-09-07** `dc3782214715` — 1 info
  - api operation id `post-job-queue-v1-jobs` removed and replaced with `PostJob`
- **2020-09-07** `a58b3b1c70b6` — 1 info
  - endpoint added
- **2020-09-05** `87cae065c674` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/osbuild/apis/osbuild-composer-worker/docs/jobs/post.md) · [API](https://skmtc.dev/osbuild/apis/osbuild-composer-worker.md) · [Page](https://skmtc.dev/osbuild/apis/osbuild-composer-worker/changes/jobs/post)