---
title: Recover files (from Recycle Bin)
description: POST /nd/api/file/restore_file: Restore files (from the recycle bin) interface description, including path, method, parameters and return information.
slug: api-post-nd-api-file-restore-file
lang: en
category: File API
category_order: 8
order: 116
api_method: POST
api_path: /nd/api/file/restore_file
api_label: Recover files (from Recycle Bin)
keywords:
  - API
  - Recover files (from Recycle Bin)
  - /nd/api/file/restore_file
---

# Restore files (from recycle bin)

| Properties | Values |
| --- | --- |
| HTTP method | `POST` |
| Interface path | `/nd/api/file/restore_file` |
| Category | File API |

## Interface description

Interface path: `/nd/api/file/restore_file`

HTTP method: `POST`


**HTTP method:** `POST`

#### POST request body parameters

Parameter name Comment (description)
file_ids[] target file id array string[]
restoreAll If file_ids is not filled in, restoreAll is true to restore all files in the recycle bin, boolean
#### The return information is as follows

## Call instructions

- Before calling, you need to complete [Get token](api-post-api-token-do.md) or the corresponding login-free authentication, and carry `Authorization: Bearer <access_token>` in the request header.
- If there are differences in parameters and return fields due to deployment versions, the actual private cloud API documents and joint debugging results should prevail.
- Category: File API.