Skip to content

asset_restore

Managementcatalog

Restore Deleted Assets

Not in the default tool list

This tool lives in the tool catalog. Discover it with scenario_tools_search (or enumerate everything with scenario_tools_list) and run it via scenario_tool_execute_write. To list every tool directly, connect with ?toolsets=full.

Restore (undelete) assets deleted in the last 30 days (bin, trash), up to 100 at once. Find them with assets_list and deleted=true. Tags and collections are not restored. Restoring is part of the Max plan and above (Max, Team, legacy Premium, Enterprise); on other plans the API refuses it. Returns: { restored, skipped }: restored lists the asset ids brought back; skipped lists { asset_id, reason } for each id left as it was: not-found, not-deleted, or expired (deleted more than 30 days ago, or past the Free plan retention). Example: "Bring back the images I deleted yesterday" -> assets_list with deleted=true, then asset_restore with their ids. Don't use when: the asset was never deleted (asset_update edits it), or a model was deleted: use model_restore.
idempotentopen-world

Parameters

NameTypeRequiredDescription
asset_idsarray✓Ids of deleted assets to restore, from assets_list with deleted=true (1 to 100).
team_idstring—Team ID. Required with project_id for OAuth callers; an API key is scoped by the key.
project_idstring—Project ID. Required with team_id for OAuth callers; an API key is scoped by the key.
response_formatenum(json | markdown)jsonOutput format: 'json' for structured data, 'markdown' for human-readable text.