Restore Dashboard Version
POST/dashboard/:dashboardID/recover/version
Bring back chosen fields from a saved version of a dashboard, or of a TagoRUN user's AI Dashboard copy.
The restore is saved as a new version, so restoring another one undoes it.
With run_user, restore a version of that TagoRUN user's own copy of an AI Dashboard instead. Only the
copy's layout comes back, so fields must include setup. Restoring a version saved by a reset resets
the copy again; restoring an earlier one brings the copy back. See
Per Run User Generation.
Requires a profile token with Full or Write permission, or an Analysis token whose Access Management
policy allows Dashboard → Edit on the dashboard. A TagoRUN user token restores the user's own copy
when the user holds Dashboard → AI dashboard generation on the dashboard, and cannot send run_user.
On an AI Dashboard, a restore never runs alongside a generation: while the layout or the copy is generating, restoring, or resetting, the request answers 429.
Request
Responses
- 200
- 400
- 404
- 429
Version restored
Invalid body, an unknown version, fields without setup on a user's copy, a TagoRUN user token that sent run_user, or a token that cannot restore. A TagoRUN user without Dashboard → AI dashboard generation on the dashboard gets "Authorization denied".
With run_user or a TagoRUN user token: the dashboard is not an AI Dashboard of this profile, or the user is unknown, inactive, or has no Dashboard → Access to it.
The AI Dashboard's layout or this user's copy is generating, restoring, or resetting.