> This page is for Referencia de la API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://signalcore.ai/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://signalcore.ai/docs/_mcp/server.

# Preview 

GET https://signalcore.ai/v1/files/{path}/preview

What the file is, as a viewer draws it (FILES.md, Preview): one shape with a `kind`.

Reference: https://signalcore.ai/docs/referencia/archivos/preview

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `path` (string, required)

## Response

### 200

Successful Response

- `FilesPreviewResponse`
  - `kind`: `pdf`
    - `pages` (integer, required, nullable)
  - `kind`: `sheet`
    - `sheets` (list of PreviewSheet, required)
    - `truncated` (boolean, required)
  - `kind`: `document`
    - `html` (string, required)
    - `truncated` (boolean, required)
  - `kind`: `slides`
    - `slides` (list of PreviewSlide, required)
    - `truncated` (boolean, required)
  - `kind`: `markdown`
    - `text` (string, required)
    - `truncated` (boolean, required)
  - `kind`: `text`
    - `text` (string, required)
    - `truncated` (boolean, required)
  - `kind`: `json`
    - `text` (string, required)
    - `truncated` (boolean, required)
  - `kind`: `code`
    - `language` (string, required)
    - `text` (string, required)
    - `truncated` (boolean, required)
  - `kind`: `image`
    - `media_type` (string, required)
  - `kind`: `video`
    - `media_type` (string, required)
  - `kind`: `audio`
    - `media_type` (string, required)
  - `kind`: `unknown`

## Errors

### 422 Files Preview Request Unprocessable Entity Error

Validation Error

- `detail` (list of ValidationError, optional)

## Types

### PreviewSheet

- `name` (string, required)
- `columns` (list of string, required, nullable)
- `rows` (list of list of string, required)
- `total_rows` (integer, required)

### PreviewSlide

- `title` (string, required, nullable)
- `text` (string, required)
- `notes` (string, required, nullable)

### ValidationError

- `loc` (list of ValidationErrorLocItem, required)
- `msg` (string, required)
- `type` (string, required)
- `input` (any, optional)
- `ctx` (map from string to any, optional)

### ValidationErrorLocItem

## Examples

**Response**

```json
{
  "kind": "pdf",
  "pages": 1
}
```

**SDK Code**

```python
import requests

url = "https://signalcore.ai/v1/files/path/preview"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```