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

# Storage Tool List

`POST /api/internal/storage/tool/list`

## 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/list`
- Auth: HTTP bearer

List the agent's (or team's) persisted documents, newest-first, with optional filters.

## Headers

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

## Request body

- StorageListRequest
  - `limit` integer, nullable
  - `cursor` string, nullable
  - `filename_prefix` string, nullable
  - `content_type_prefix` string, nullable
  - `folder` string, nullable

## Response `200`

Successful Response

- StorageListResponse
  - `items` StorageListItem[], required
    - `file_id` string, required
    - `filename` string, required
    - `content_type` string, required
    - `size_bytes` integer, required
    - `folder` string, nullable
    - `updated_at` string, required
  - `next_cursor` string, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Validation Error

---

[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)