# REST-API: Jobs

> Die 3 Operationen des Bereichs Jobs, mit Parametern, Bodys und Antworten.

Source: https://pithyx.org/de/docs/reference/api/jobs/
Markdown: https://pithyx.org/de/docs/reference/api/jobs.md

Erzeugt aus dem OpenAPI-Dokument des Daemons. Konventionen, Anmeldung, der CSRF-Header und der WebSocket stehen unter [API](https://pithyx.org/de/docs/developers/daemon/api/).

## GET /api/jobs

The signed-in user's 100 most recent jobs, newest first. Finished jobs are kept for 7 days. Live progress comes on the topic jobs/{id}.

**Antworten**

- 200: `application/json`: [Job](https://pithyx.org/de/docs/reference/api/schemas/#job)[]

Jeder Fehler antwortet mit Problem Details (`application/problem+json`) und einem stabilen Code aus der [Fehlerreferenz](https://pithyx.org/de/docs/reference/errors/).

## GET /api/jobs/{id}

A job of the signed-in user; administrators can read every job. Others get 404 jobs.job.not_found.

**Parameter**

| Name | Ort  | Typ             | Pflicht | Beschreibung |
| ---- | ---- | --------------- | ------- | ------------ |
| `id` | path | integer (int64) | ja      |              |

**Antworten**

- 200: `application/json`: [Job](https://pithyx.org/de/docs/reference/api/schemas/#job)

Jeder Fehler antwortet mit Problem Details (`application/problem+json`) und einem stabilen Code aus der [Fehlerreferenz](https://pithyx.org/de/docs/reference/errors/).

## POST /api/jobs/{id}/cancel

Cancels a queued job right away and asks a running one to stop; it ends as cancelled once its work gives up. Cancelling a finished job changes nothing.

**Parameter**

| Name | Ort  | Typ             | Pflicht | Beschreibung |
| ---- | ---- | --------------- | ------- | ------------ |
| `id` | path | integer (int64) | ja      |              |

**Antworten**

- 204

Jeder Fehler antwortet mit Problem Details (`application/problem+json`) und einem stabilen Code aus der [Fehlerreferenz](https://pithyx.org/de/docs/reference/errors/).