---
title: "Prepare a Drive file preview"
method: POST
path: "/api/v1/file-trees/{nodeId}/preview"
tags: ["File Trees"]
---

# Prepare a Drive file preview

`POST /api/v1/file-trees/{nodeId}/preview`

## Request

- Base URL: `https://api-docs.busabase.com`
- URL: `https://api-docs.busabase.com/api/v1/file-trees/{nodeId}/preview`
- Auth: none declared

## Path parameters

- `nodeId` string, required

## Request body

- object
  - `filePath` string, required
  - `type` unknown, required

## Response `200`

Returns the built-in provider, a short-lived PreviewFile URL, or a recoverable provider failure.

- union
  - object
    - `state` unknown, required
    - `provider` unknown, required
  - object
    - `state` unknown, required
    - `provider` unknown, required
    - `previewUrl` string, uri, required
    - `expiresAt` string, date-time, required
  - object
    - `state` unknown, required
    - `provider` unknown, required
    - `reason` 'not_configured' | 'invalid_configuration' | 'file_too_large' | 'unsupported' | 'authentication_failed' | 'rate_limited' | 'timeout' | 'service_unavailable' | 'invalid_response', required
    - `retryable` boolean, required

---

[API](https://skmtc.dev/busabase/apis/busabase-api.md) · [All operations](https://skmtc.dev/busabase/apis/busabase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/busabase/apis/busabase-api/revisions/bc6a7d5ff4c1?raw)