# File storage for AI agents

Give your agent’s files a download link.

Your agent made a report on a remote machine. Let it upload the file through Munition and give you a public link. Anyone with the link can download it.

One Munition upload tested on 10 November 2026. TaskFuel handles access and payment; Munition hosts the file. Your agent checks the quote before buying a slot.

Provider in the worked example: Munition.

Price shown for this route: 0.5¢ per upload slot · checked 10 Nov 2026.



## From a local file to a public link.

### Reserve a slot

One file up to 10 MiB (10,485,760 bytes), with seven-day retention. Send the file size, MIME type and SHA-256 checksums. The response includes upload instructions and a public URL.

Price: $0.005 / slot.

### Upload the actual file

Your agent sends the exact file bytes directly to the returned upload URL, using its PUT method and required headers. A paid slot alone does not upload the file.

Price: Included in the slot.

### Check and share the link

Download the public URL and compare it with the original before sharing. Keep the returned expiry date with the link. Anyone who has the link can access the file.

Price: Public download.


## A real example

Tested on 2026-11-10 through Munition.

We bought one upload slot, uploaded a small CSV, then downloaded the public link and compared every byte.

Your agent asked: Upload report.csv, then download it and check that the bytes match.

Returned in this test:

- File: [Download a saved copy of the tested CSV](/examples/file-storage/report.csv)
- Upload / download: HTTP 200 / HTTP 200
- Validation: All 38 bytes matched the original
- Link expiry: 17 Nov 2026, 01:58 UTC (provider-reported)
- Balance after call: $0.92

Charged in this test: $0.005.

One small CSV tested. The sample above is a permanent copy on this site, not the temporary provider link. We did not test larger files, renewal, deletion or expiry enforcement.




## Try the API request

Use your TaskFuel API key as TASKFUEL_API_KEY in your terminal or server. Keep it out of browser code.

### 1. Check the price

This request checks the price without paying. This request reserves a slot for the exact 38-byte sample CSV linked above. For your own file, calculate its byte length and SHA-256 digest in both lowercase hex and Base64, and replace the filename and MIME type. Do not reuse these checksums for different bytes.

```sh
curl --fail-with-body https://app.taskfuel.ai/v1/call \
  -H "Authorization: Bearer $TASKFUEL_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'TASKFUEL_REQUEST'
{
  "url": "https://api.munition.io/v1/uploads",
  "method": "POST",
  "body": {
    "filename": "report.csv",
    "mime": "text/csv",
    "size": 38,
    "sha256": "f5f5891b84aab9333814f14b3223dbecdbee04ac86462316f4c3a31c60ccacd8",
    "sha256Base64": "9fWJG4SquTM4FPFLMiPb7NvuBKyGRiMW9MOjHGDMrNg="
  },
  "dryRun": true
}
TASKFUEL_REQUEST
```

### 2. Run the request

Review amount_usd in the quote. To pay and run, change dryRun to false and add maxAmountUsd with that approved amount inside the same JSON object. Keep the inputs unchanged; this limit applies to one call.

### 3. Read the result

The paid response contains uploadUrl, uploadMethod, uploadHeaders, publicUrl and expiresAt. Send the file bytes directly to uploadUrl with the returned method and headers before that upload URL expires. Then download publicUrl and verify the contents before sharing. Keep the signed upload URL private; share only publicUrl.

[Why remote agents need shareable file links](https://taskfuel.ai/blog/file-storage-for-ai-agents/)

[Setup and API reference](https://taskfuel.ai/docs/) · [Job polling and timeout recovery](https://app.taskfuel.ai/using.md)


## Connect your agent

Read the [setup guide](https://taskfuel.ai/docs/setup/) and choose the connection your agent supports.

Use one TaskFuel account and prepaid balance. Inspect the provider and request quote before a paid call, then review the returned response and recorded charge.



## When to use it

### Get the report off the server.

An agent running in the cloud or CI can turn a file you cannot reach into a browser download.

### Send the file with the summary.

Ask for a download link alongside the findings so you can open the actual CSV, PDF or chart.

### Use what you already have.

If the file is on your own machine, open it locally. If your agent already has suitable Drive or bucket access, use that. TaskFuel helps when that connection is missing.




## Questions

### How does file storage for AI agents work?

Your connected agent buys a Munition upload slot through TaskFuel, uploads the file directly to the returned URL, then gives you the public download link. TaskFuel handles discovery and payment; Munition hosts the file.

### What does an upload cost?

Our 10 November 2026 test quoted and charged $0.005 for one file up to 10 MiB with seven-day retention. Your agent checks the price for your request before paying. The four demo scenes show one upload, not four charges.

### Do I need a separate storage account?

You need a TaskFuel account, prepaid balance and connected agent. This upload route does not require you to create a separate Munition account or configure a storage bucket.

### Are the files private?

Anyone with the public link can download the file. Use this route only for files you are comfortable sharing that way. The signed upload URL is separate and should stay private.

### How long does the link last?

This route specifies seven-day retention and returns an expiresAt timestamp. Our test returned 17 November 2026 at 01:58 UTC. Keep your original file. We have not tested expiry enforcement or renewal.

### Does paying for a slot upload my file?

No. Your agent still needs access to the file bytes and must send them to the returned upload URL with the required headers. Verify the public download before treating the file as shared. If the upload fails, do not buy another slot without checking the first response.

### Can I use it for persistent agent memory or private backups?

This guide covers temporary public file sharing. Use storage with suitable access controls and retention guarantees for private backups or persistent agent memory.



## Reference

- [Read this guide on the website](https://taskfuel.ai/tools/file-storage-for-ai-agents/).
- [Browse providers and capabilities](https://taskfuel.ai/catalog/).
- [Pricing](https://taskfuel.ai/pricing/).
- [Agent instructions](https://taskfuel.ai/llms.txt).
