---
title: "Restore assets from trash"
method: POST
path: "/api/assets/restore"
tags: ["assets"]
---

# Restore assets from trash

`POST /api/assets/restore`

Restores trashed assets so they reappear in default list/search results. Idempotent — assets that are already live are silently skipped.

Pairs with `trash_assets`: assets soft-deleted there can be brought back here within the retention window. To restore a whole trashed library, use `restore_library`.

## Query parameters

- `library_id` string, nullable — Library that owns the assets. Optional if the user has a single live (non-trashed) library; required when they have multiple.

## Request body

- AssetIdsRequest — Request body carrying a list of asset IDs for the bulk trash, restore, and permanent-delete endpoints.
  - `ids` string[], required — Asset IDs (each with the `asset_` prefix) to operate on. Up to 200 ids per request.

## Response `200`

Successful Response

- DeletionResponse — Acknowledgment body returned by destructive endpoints (delete / trash / restore / permanently delete / remove-from-album / empty-trash). Carries no fields — the HTTP 200 + empty JSON object is itself the success signal. Exists so MCP tools generated from these endpoints have a real ``outputSchema`` (rather than the null schema FastMCP emits for 204 responses), which ChatGPT's MCP submission tooling requires.

## Other responses

- `401` — Missing, invalid, or expired credentials.
- `403` — The credentials are valid but not authorized for this operation — for example an API key whose action or library scope excludes it, or a credential type this operation does not accept.
- `404` — Not found
- `422` — Validation Error
- `429` — Rate limit exceeded. Retry after the interval in the `Retry-After` header.

---

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