---
title: "Prepare an isolated read-only Saved Version preview, if enabled by the deployment"
method: POST
path: "/api/mcp/tools/preview_saved_version"
tags: ["tools"]
---

# Prepare an isolated read-only Saved Version preview, if enabled by the deployment

`POST /api/mcp/tools/preview_saved_version`

## Request

- Base URL: `https://finestructure.ai`
- URL: `https://finestructure.ai/api/mcp/tools/preview_saved_version`
- Auth: HTTP bearer

Prepare an isolated read-only Saved Version preview, if enabled by the deployment. Returns compiled files for an offline sandbox, never restores files or reads live records. Never execute the returned program with host credentials. Requires app access and versions:read.

## Request body

- object
  - `app_id` string, required
  - `snapshot_id` string, required

## Response `200`

Tool executed successfully

- ToolResult
  - `ok` boolean, required
  - `tool` string, required
  - `result` object, required

## Other responses

- `400`: Invalid arguments for this tool
- `401`: Missing or invalid bearer token
- `402`: Not enough credits on the account
- `403`: Token scope does not permit this tool
- `404`: Unknown tool name
- `429`: Rate limit exceeded, retry after the indicated delay
- `500`: Internal error while executing the tool

## Changes

- **2026-10-19** `02c50ed5fd70`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/finestructure/apis/fine-structure-api/changes/api/mcp/tools/preview_saved_version/post.md)

---

[API](https://skmtc.dev/finestructure/apis/fine-structure-api.md) · [All operations](https://skmtc.dev/finestructure/apis/fine-structure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finestructure/apis/fine-structure-api/revisions/02c50ed5fd70?raw)
