---
title: "Create file restore"
method: POST
path: "/v1/restore/file"
tags: ["Restores (File)"]
---

# Create file restore

`POST /v1/restore/file`

## Request body

- object
  - `device_id` string, required — ID of a device
  - `passphrase` string — User passphrase. If the agent has a user passphrase, you must provide it here.
  - `snapshot_id` string, required — ID of a snapshot

## Response `201`

Created

- FileRestore — File restore object that represents a snapshot that has been restored and files exposed.
  - `agent_id` string, required — ID of an agent
  - `created_at` string, date-time, required — Creation timestamp
  - `device_id` string, required — ID of a device
  - `expires_at` string, date-time — Expiration timestamp
  - `file_restore_id` string, required — ID of a file restore
  - `purpose` 'test' | 'disaster', required — Purpose for creating the virtual machine or file restore. If this is set to disaster, Slide Support will recieve a notification that you are in a disaster. File restores not created by the slide box for file system verification will have this field set to disaster.
  - `snapshot_id` string, required — ID of a snapshot

## Other responses

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

---

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