File Management

Available ActionsEach successful request consumes credits as outlined below.

upload_standard^10crupload_large^20crlistgetdownloaddeleteshare^5craccess_historyupdate_metadata^5crextend_expiration^10cr

Details

Upload, list, retrieve, share, download, delete, and manage files stored in AgentPMT cloud storage. This product now owns the full file lifecycle, including signed upload URLs for files up to 10MB and for files over 10MB up to 100MB, budget-scoped file listing with preview URLs, fresh signed download URLs, direct base64 download for smaller files, password-protected sharing, metadata and tag updates, access-history inspection, and expiration extension. All file operations are scoped to the current budget for isolation and are designed to let one budget create persistent files that can be revisited across later agent runs.

Use Cases

Small file upload, large file upload, signed upload URL generation, temporary file hosting, budget-scoped file storage, file inventory, file preview listing, image preview retrieval, get file metadata, refresh signed URL, download file as base64, delete uploaded file, create password-protected file share, secure file delivery, metadata tagging, file organization, access audit trail, extend file expiration, AI agent file persistence, report delivery, export storage, dataset handoff, document sharing, cross-run file retrieval, chat attachment storage, automation workflow file output

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to https://api.agentpmt.com/mcp. All tool execution happens in the cloud and the server cannot edit any files on your computer.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "6948b078b54506f955d789ed",
    "parameters": {
      "action": "upload_standard",
      "content_length_bytes": 1
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "6948b078b54506f955d789ed",
    "parameters": {
        "action": "upload_standard",
        "content_length_bytes": 1
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6948b078b54506f955d789ed",
  parameters: {
    "action": "upload_standard",
    "content_length_bytes": 1
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6948b078b54506f955d789ed",
  parameters: {
    "action": "upload_standard",
    "content_length_bytes": 1
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:6948b078b54506f955d789ed
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/6948b078b54506f955d789ed/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

Actions(10)

upload_standard^10cr9 params(1 required)

Generate a signed upload URL for a file up to 10MB. After receiving the URL, perform a PUT request with the exact file bytes and returned headers.

content_length_bytesrequiredinteger

Exact file size in bytes. Must match the Content-Length header on PUT. Range: 1-10485760 (10MB).

Range: 1 - 10485760

filenamestring

Original filename including extension. If omitted, a filename is auto-generated.

content_typestring

MIME type of the file. Default: application/octet-stream.

expiration_daysinteger

Days until file expires and is automatically deleted (1-7). Default: 7.

Range: 1 - 7

sharedboolean

Whether the file should be shareable through a password-protected public URL.

password_max_usesinteger

Maximum number of uses for the auto-generated share password (1-10). Only relevant when shared is true.

Range: 1 - 10

password_max_minutesinteger

Minutes until the auto-generated share password expires (1-10). Only relevant when shared is true.

Range: 1 - 10

metadataobject

Custom metadata as key-value pairs to attach to the file.

tagsarray

Tags for categorization.

Array of: string

upload_large^20cr9 params(1 required)

Generate a signed upload URL for a file over 10MB and up to 100MB. After receiving the URL, perform a PUT request with the exact file bytes and returned headers.

content_length_bytesrequiredinteger

Exact file size in bytes. Must match the Content-Length header on PUT. File size must be over 10MB and up to 100MB.

Range: ... - 104857600

filenamestring

Original filename including extension. If omitted, a filename is auto-generated.

content_typestring

MIME type of the file. Default: application/octet-stream.

expiration_daysinteger

Days until file expires and is automatically deleted (1-7). Default: 7.

Range: 1 - 7

sharedboolean

Whether the file should be shareable through a password-protected public URL.

password_max_usesinteger

Maximum number of uses for the auto-generated share password (1-10). Only relevant when shared is true.

Range: 1 - 10

password_max_minutesinteger

Minutes until the auto-generated share password expires (1-10). Only relevant when shared is true.

Range: 1 - 10

metadataobject

Custom metadata as key-value pairs to attach to the file.

tagsarray

Tags for categorization.

Array of: string

list6 params

List active uploaded files for the current budget with optional filtering and pagination. Returns newest files first and includes cached preview URLs when available.

tagsarray

Filter to files matching any of these tags.

Array of: string

date_fromstring

Only files created on or after this date (ISO 8601).

date_tostring

Only files created on or before this date (ISO 8601).

limitinteger

Maximum number of files to return (1-100).

Range: 1 - 100

offsetinteger

Number of files to skip for pagination.

Range: 0 - ...

url_expiration_minutesinteger

Requested preview URL validity in minutes when a preview URL must be refreshed (1-10080, default: 10080).

Range: 1 - 10080

get2 params(1 required)

Get file metadata and a fresh signed download URL for a specific file.

file_idrequiredstring

File UUID returned from upload.

url_expiration_minutesinteger

How long the signed URL should remain valid in minutes (1-10080, default: 10080).

Range: 1 - 10080

download3 params(1 required)

Download file content as base64 for files up to 5MB, or return a signed URL for larger files.

file_idrequiredstring

File UUID returned from upload.

return_contentboolean

If true, returns base64 file content for files up to 5MB. Otherwise returns a signed URL.

url_expiration_minutesinteger

How long the signed URL should remain valid in minutes when returning a URL (1-10080, default: 10080).

Range: 1 - 10080

delete1 param(1 required)

Permanently delete a file from storage.

file_idrequiredstring

File UUID returned from upload.

share^5cr3 params(1 required)

Create or refresh a password-protected public share link for an existing file.

file_idrequiredstring

File UUID returned from upload.

password_max_usesinteger

Maximum number of times the auto-generated password can be used (1-10). Leave empty for unlimited uses.

Range: 1 - 10

password_max_minutesinteger

Minutes until the auto-generated password expires (1-10). Leave empty for no expiration.

Range: 1 - 10

access_history2 params(1 required)

View password-protected share access history for a file.

file_idrequiredstring

File UUID returned from upload.

limitinteger

Maximum number of access records to return (1-100).

Range: 1 - 100

update_metadata^5cr5 params(1 required)

Update metadata and tags on a file.

file_idrequiredstring

File UUID returned from upload.

metadataobject

Metadata key-value pairs to merge into existing metadata.

tagsarray

Replace all existing tags with this list.

Array of: string

add_tagsarray

Add these tags while preserving current tags.

Array of: string

remove_tagsarray

Remove these tags from the current tag set.

Array of: string

extend_expiration^10cr1 param(1 required)

Extend a file's expiration date by 7 days from the current expiration.

file_idrequiredstring

File UUID returned from upload.

Usage Instructions

Usage guidance provided directly by the developer for this product.

File Management

Name: File Management
Brand: Apoth3osis
SKU: 6948b078b54506f955d789ed
Availability: InStock

Manage the complete file lifecycle from a single tool. This includes uploading new files, listing existing files for the current budget, retrieving metadata and signed URLs, downloading content, deleting files, creating password-protected share links, auditing access history, updating metadata and tags, and extending expiration.

Actions

`upload_standard`

Generate a signed upload URL for a file up to 10MB.

Required fields:

content_length_bytes: exact file size in bytes, 1 to 10,485,760

Optional fields:

filename
content_type
expiration_days (1-7)
shared
password_max_uses (1-10)
password_max_minutes (1-10)
metadata
tags

`upload_large`

Generate a signed upload URL for a file over 10MB and up to 100MB.

Required fields:

content_length_bytes: exact file size in bytes, greater than 10,485,760 and up to 104,857,600

Optional fields:

filename
content_type
expiration_days (1-7)
shared
password_max_uses (1-10)
password_max_minutes (1-10)
metadata
tags

`list`

List active files for the current budget. Results are newest first and include preview URLs when available.

Optional fields:

tags
date_from
date_to
limit
offset
url_expiration_minutes

`get`

Get metadata and a fresh signed download URL for a file.

Required fields:

file_id

Optional fields:

url_expiration_minutes

`download`

Download base64 content for files up to 5MB, or get a signed URL for larger files.

Required fields:

file_id

Optional fields:

return_content
url_expiration_minutes

`delete`

Delete a file permanently.

Required fields:

file_id

`share`

Create or refresh a password-protected public share link.

Required fields:

file_id

Optional fields:

password_max_uses
password_max_minutes

`access_history`

View share access history for a file.

Required fields:

file_id

Optional fields:

limit

`update_metadata`

Update metadata and tags on a file.

Required fields:

file_id

Optional fields:

metadata
tags
add_tags
remove_tags

`extend_expiration`

Extend expiration by 7 days.

Required fields:

file_id

Notes

Upload actions return a signed upload_url; you must then PUT the file bytes to that URL using the returned headers.
list is budget-scoped and includes preview URLs when the file type supports preview.
Signed URLs can be requested for up to 7 days.
download with return_content: true is limited to files 5MB or smaller.
Share passwords are always auto-generated.
extend_expiration adds 7 days each time it is called.

About The Developer

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

File Management

Description