---
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

- RequestJobRequest
  - `types` string[], required
  - `arch` string, required
  - `worker_id` string

## Response `201`

Created

- RequestJobResponse
  - `id` string, required
  - `kind` string, required
  - `href` string, required
  - `location` string, required
  - `artifact_location` string, required
  - `type` string, required
  - `args` unknown
  - `dynamic_args` unknown[]
    - unknown

## Other responses

- `204` — No job was available, try again
- `4XX`
- `5XX`

## 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`
  - …11 more
- **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`

[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-service-production.skmtc.workers.dev/v1/apis/osbuild/osbuild-composer-worker/revisions/f6de32b9b1a1/schema)