---
title: "Push a file to the protected system"
method: POST
path: "/v1/restore/file/{file_restore_id}/push"
tags: ["Restores (Push)"]
---

# Push a file to the protected system

`POST /v1/restore/file/{file_restore_id}/push`

## Path parameters

- `file_restore_id` string, required — ID of a file restore

## Request body

- object
  - `destination_folder` string, required — The folder on the protected system where the pushed file is restored. For security reasons, restores are only permitted to a `SlideRestore` folder rooted at a known mount point on the agent: for Windows agents, the root of a drive (e.g. `C:\SlideRestore`); for Linux agents, an absolute path under a mounted volume that ends in `/SlideRestore` (e.g. `/SlideRestore` for the root mount, or `/data/SlideRestore` for a `/data` mount).
  - `source_file_path` string, required — Path of the file as it appears inside the mounted file restore — not the file's path on the protected system. The leading path component is the source volume's identifier (the drive letter for Windows, e.g. `C`, or `root` for the root mount on Linux), followed by forward-slash-separated path components (e.g. `C/Users/Administrator/Documents/ImportantFile.docx` for a Windows C: drive, or `root/home/admin/important.txt` for a Linux root mount).

## Response `201`

Created

- FileRestorePush — File restore push object that represents an attempt to restore a file to a protected system.
  - `destination_folder` string, required — The folder on the protected system where the pushed file is restored. For security reasons, restores are only permitted to a `SlideRestore` folder rooted at a known mount point on the agent: for Windows agents, the root of a drive (e.g. `C:\SlideRestore`); for Linux agents, an absolute path under a mounted volume that ends in `/SlideRestore` (e.g. `/SlideRestore` for the root mount, or `/data/SlideRestore` for a `/data` mount).
  - `end_time` string, date-time — Timestamp of when the push operation ended
  - `file_restore_id` string, required — ID of a file restore
  - `file_restore_push_id` string, required — ID of a file restore push
  - `size` integer — Size of the file in bytes
  - `source_file_path` string, required — Path of the file as it appears inside the mounted file restore — not the file's path on the protected system. The leading path component is the source volume's identifier (the drive letter for Windows, e.g. `C`, or `root` for the root mount on Linux), followed by forward-slash-separated path components (e.g. `C/Users/Administrator/Documents/ImportantFile.docx` for a Windows C: drive, or `root/home/admin/important.txt` for a Linux root mount).
  - `start_time` string, date-time, required — Timestamp of when the push operation started
  - `state` 'created' | 'in_progress' | 'completed' | 'failed' | 'canceled', required — Current state of the push operation

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

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