---
title: "Update Backup Status"
method: PATCH
path: "/internal/backups/{backup_id}/status"
tags: ["internal"]
---

# Update Backup Status

`PATCH /internal/backups/{backup_id}/status`

## Request

- Base URL: `https://api.mengi.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mengi.cloud/internal/backups/{backup_id}/status`
- Auth: none declared. Required headers: `x-service-token`

Update the status of a database backup (worker only).

## Path parameters

- `backup_id` string, uuid, required

## Headers

- `x-service-token` string, required

## Request body

- BackupStatusUpdate
  - `status` string, required
  - `error_message` string, nullable
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `s3_path` string, nullable
  - `size_bytes` integer, nullable
  - `barman_backup_id` string, nullable
  - `barman_server_name` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mengi/apis/mengi-cloud.md) · [All operations](https://skmtc.dev/mengi/apis/mengi-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/mengi/apis/mengi-cloud/revisions/70dc8775b002?raw)