---
title: "Restores the document with the specified id from the trash."
method: POST
path: "/documents/trash/{documentId}/restore"
tags: ["documents"]
---

# Restores the document with the specified id from the trash.

`POST /documents/trash/{documentId}/restore`

Please note that restoring a document using this method will asynchronously and eventually update or recreate the document and the related entities such as document versions or its content.
            This operation is idempotent, if applied to an already restored document, it will return a NoContent result.
            
            <Check title="Required Permissions" icon="key">The user must have at least `write` permissions for the specified document.</Check>

## Path parameters

- `documentId` string, uuid, required

## Query parameters

- `alsoRestoreChildren` boolean

## Headers

- `Authorization` string, required

## Response `204`

No Content

- object

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.net/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awork-io/api-v1-reference/versions/f784a53f60df/schema)