---
title: "Backup server"
method: POST
path: "/v0/server/backup"
tags: ["server"]
---

# Backup server

`POST /v0/server/backup`

Backup the API server database. The user must be an admin on the server to use this route.

## Request body

- JsonBackup
  - `compress` boolean, nullable — Compress the database backup with gzip. This operation runs first.
  - `data_store` 'aws_s3'
  - `remove` boolean, nullable — Remove the local copy of the database backup. This operation runs third.

## Response `201`

successful creation

- JsonBackupCreated
  - `created` string, date-time, required

## Other responses

- `4XX` — Error
- `5XX` — Error

## Changes

> 64 revisions in range; 38 could not be searched.

- **2026-03-20** `36c8ad753527` — 1 warning, 1 info
  - removed the request property `remove`
  - added the new optional request property `rm`

[Change history](https://skmtc.dev/bencherdev/apis/bencher-api/changes/v0/server/backup/post.md)

---

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