---
title: "Download Backup"
method: GET
path: "/api/v1/backups/download"
tags: ["Backups"]
---

# Download Backup

`GET /api/v1/backups/download`

Download a backup archive.

This endpoint requires the `data:read_write` scope. The `backups:read`
scope only grants access to `GET /api/v1/backups`.

Validates that the requested backup belongs to the authenticated user and
redirects to a signed CloudFront URL that expires after one minute.

## Query parameters

- `file` string, required — Backup file name returned in a backup download URL.

## Response `200`

Successful Response

- unknown

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/todoist/apis/todoist-api.md) · [All operations](https://skmtc.net/todoist/apis/todoist-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/todoist/todoist-api/revisions/69a962f1578f/schema)