Agentic Platform
Documentation API reference Tools Skills

Tools

Temporary Storage Read

tmp_storage_read MCP Content

Return the full text of a temporary upload.

Read a file stored in the project's temporary upload storage and return its whole text. Works on HTML, JSON, JSONL, CSV, and plain text, including gzip-compressed uploads. The file is decoded as UTF-8. A file larger than 1 MiB is refused rather than cut short: use tmp_storage_grep or tmp_storage_jq to look inside it.

Playground

POST
item
url required

Temporary upload to read. Temporary uploaded URLs on https://app.botify.com/:organization/:project/o/storage/tmp are allowed.

Credits

Fixed cost per file read. The file is one you already uploaded, and reading it happens inside Botify, so nothing further is billed.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Properties
url string required

Temporary upload to read. Temporary uploaded URLs on https://app.botify.com/:organization/:project/o/storage/tmp are allowed.

Example
{
  "url": "string"
}

Response

object
Properties
content string

Full text of the decompressed file

Default: ""

size_bytes integer

Size of the decompressed file, in bytes

Default: 0

Example
{
  "content": "",
  "size_bytes": 0
}

Endpoints

POST http://agents.botify.com/{organization}/{project}/tmp_storage_read/process
POST http://agents.botify.com/{organization}/{project}/tmp_storage_read/batch_process
POST http://agents.botify.com/{organization}/{project}/tmp_storage_read/async_process
POST http://agents.botify.com/{organization}/{project}/tmp_storage_read/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/tmp_storage_read/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {
    "url": "<url>"
  }
}'

Over MCP

This tool is exposed as the MCP tool tmp_storage_read. An MCP client passes organization, project and item as tool arguments. Set up MCP →

Raw metadata