---
title: "Storage Tool Read"
method: POST
path: "/api/internal/storage/tool/read"
tags: ["storage-tool-abi"]
---

# Storage Tool Read

`POST /api/internal/storage/tool/read`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/internal/storage/tool/read`
- Auth: HTTP bearer

Read a previously-persisted document by filename (preferred) or file_id.

## Headers

- `X-Business-Id` string
- `X-Conversation-Id` string, nullable
- `X-Agent-Id` string, nullable

## Request body

- StorageReadRequest
  - `filename` string, nullable
  - `file_id` string, nullable

## Response `200`

Successful Response

- StorageReadResponse
  - `file_id` string, required
  - `filename` string, required
  - `content_type` string, required
  - `size_bytes` integer, required
  - `content` string, nullable
  - `presigned_url` string, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity

---

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