---
title: "Create Archiver Job"
method: POST
path: "/archiver/jobs"
tags: ["archiving"]
---

# Create Archiver Job

`POST /archiver/jobs`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/archiver/jobs`
- Auth: HTTP basic

## Request body

- CreateJobBody
  - `id` string, uuid, required
  - `type` 'archive' | 'retrieve', required

## Response `201`

Job Created

- CreateJobResp
  - `uuid` string, uuid, required
  - `name` string, required

## Other responses

- `422`: Data Validation Error
- `500`: Internal Server Error

## Changes

> 17 revisions in range; 4 not diffed.

- **2025-10-28** `fe11b70c6405`: 4 breaking, 2 warning, 2 info
  - added the new required request property `id`
  - added the new required request property `type`
  - removed the required property `Name` from the response with the `201` status
  - removed the required property `Uuid` from the response with the `201` status
  - …4 more
- **2025-05-12** `0b38e9ad3468`: 1 info
  - the endpoint scheme security `BasicAuth` was added to the API
- **2025-01-23** `007651d13d90`: 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `201`
- **2025-01-07** `fb94fdb13415`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/swissopenem/apis/ethz-archiver-service/changes/archiver/jobs/post.md)

---

[API](https://skmtc.dev/swissopenem/apis/ethz-archiver-service.md) - [All operations](https://skmtc.dev/swissopenem/apis/ethz-archiver-service/llms.txt) - [OpenAPI document](https://skmtc.dev/swissopenem/apis/ethz-archiver-service/revisions/527aef2c43cd?raw)