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

# Storage Tool Write

`POST /api/internal/storage/tool/write`

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

Upsert a text/code/JSON document on (filename, agent_id) for the agent's owner.

## Headers

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

## Request body

- StorageWriteRequest
  - `filename` string, required
  - `content` string, required
  - `content_type` string, nullable
  - `description` string, nullable
  - `folder` string, nullable

## Response `200`

Successful Response

- StorageWriteResponse
  - `file_id` string, required
  - `s3_key` string, required
  - `size_bytes` integer, required
  - `audit_id` string, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `413`: Request Entity Too Large
- `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)