Skip to main content
POST
Restore Items

Authorizations

Authorization
string
header
required

JWT in Authorization header. 'Bearer ' prefix optional.

Body

application/json

API request schema for restoring filesystem items from the project trash.

The backend resolves each item's restore destination from its pre_trash_directory_id. If the original directory no longer exists or is itself in trash, items fall back to the project root directory. Name conflict handling follows the same pattern as the move endpoint.

project_id
string<uuid>
required

Project ID the items belong to

asset_ids
string<uuid>[] | null

List of asset IDs to restore from trash

directory_ids
string<uuid>[] | null

List of directory IDs to restore from trash

List of symlink IDs to restore from trash

conflict_resolutions
Conflict Resolutions · object | null

Resolution strategies for name conflicts at restore destinations. Keys are string UUIDs of conflicting items. Each value specifies the resolution strategy and optional auto-rename style. If not provided and conflicts exist, returns 409 with conflict details.

Response

Successful Response

API response schema for restoring filesystem items from trash

restored_asset_count
integer
required

Number of assets successfully restored

restored_directory_count
integer
required

Number of directories successfully restored

Number of symlinks successfully restored