---
title: "POST /api/backups/{urn}/backup"
method: POST
path: "/api/backups/{urn}/backup"
tags: ["Backups"]
---

# POST /api/backups/{urn}/backup

`POST /api/backups/{urn}/backup`

## Path parameters

- `urn` string, required

## Response `default`

- BackupRequestDto
  - `requestId` union, required — a UUID
    - string, uuid — a UUID
    - '00000000-0000-0000-0000-000000000000', uuid — a UUID
    - 'ffffffff-ffff-ffff-ffff-ffffffffffff', uuid — a UUID

## Changes

- **2025-09-19** `04aac8a043a6` — 1 breaking
  - removed the success response with the status `201`
- **2025-09-07** `8894b9440760` — 1 info
  - the `requestId` response's property pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` was added for the status `201`
- **2025-09-01** `8f4ce95cd29b` — 1 info
  - added the media type `application/json` for the response with the status `201`
- **2025-05-09** `0db10235cd0a` — 1 info
  - added the success response with the status `201`

[Change history](https://skmtc.dev/runtipi/apis/runtipi-api/changes/api/backups/:urn/backup/post.md)

---

[API](https://skmtc.dev/runtipi/apis/runtipi-api.md) · [All operations](https://skmtc.dev/runtipi/apis/runtipi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runtipi/runtipi-api/revisions/5c7deb969194/schema)