AgentPMT - The Agentic Economy

File Management

Storage
$0.05/requestMin Purchase: 20Min Purchase Price: $1

Details

File Management is a comprehensive tool for managing files uploaded to AgentPMT cloud storage by various other tools, allowing a persistent state across LLM instances that are connected to the same budget. It provides a complete set of operations including listing all uploaded files with filtering by status, tags, and date range, retrieving file metadata and fresh signed URLs, downloading file content directly as base64 for files up to 5MB, deleting files from storage, and adding or updating password-protected sharing on existing files. Additional capabilities include viewing access history to track who downloaded shared files, updating custom metadata and tags for organization, and extending file expiration by 7-day increments to keep important files available longer. All operations are scoped to the uploading account for security. This tool works exclusively with files uploaded via Upload File Standard or Upload File Large and provides the ongoing management layer for those uploads.

Use Cases

List uploaded files, file inventory, filter files by tag, filter files by date, get file metadata, refresh signed URL, download file as base64, delete uploaded file, remove file from storage, add password to file, enable file sharing, update sharing password, password protected download, file access history, download tracking, audit file access, update file metadata, add file tags, remove file tags, file organization, extend file expiration, prevent file deletion, renew file link, file management API, uploaded file administration, secure file lifecycle management, file expiration management, shared file management, automation file cleanup, batch file operations

Parameters

(required properties listed first)

action*required
Type:string
Description:Action to perform on files. Available actions: 'get_instructions' (returns tool documentation), 'list' (list active files), 'get' (get file metadata and URL), 'download' (download file content), 'delete' (delete file), 'share' (add auto-generated password protection for public sharing), 'access_history' (view access logs), 'update_metadata' (modify tags/metadata), 'extend_expiration' (add 7 days to expiration)
Allowed values:
get_instructionslistgetdownloaddeleteshareaccess_historyupdate_metadataextend_expiration
file_id
Type:string
Description:File UUID (returned from upload). Required for all actions except 'list'
tags
Type:array
Description:(For 'list' action) Filter by tags. Returns files that have ANY of the specified tags. (For 'update_metadata' action) Replace all existing tags with these tags
Array items:string
date_from
Type:string
Description:(For 'list' action) Filter files created on or after this date (ISO 8601 format, e.g., '2025-12-01T00:00:00Z')
date_to
Type:string
Description:(For 'list' action) Filter files created on or before this date (ISO 8601 format, e.g., '2025-12-31T23:59:59Z')
limit
Type:integer
Description:(For 'list' and 'access_history' actions) Maximum number of results to return (1-100)
Default:50
Minimum:1
Maximum:100
offset
Type:integer
Description:(For 'list' action) Number of results to skip for pagination
Minimum:0
url_expiration_minutes
Type:integer
Description:(For 'get' and 'download' actions) How long the signed URL should remain valid (1-1440 minutes = 1 minute to 24 hours)
Default:60
Minimum:1
Maximum:1440
return_content
Type:boolean
Description:(For 'download' action) If true, returns file content as base64 (max 5MB). If false or file is larger than 5MB, returns signed URL instead
password_max_uses
Type:integer
Description:(For 'share' action) Maximum number of times the auto-generated password can be used (1-10). Leave empty for unlimited uses
Minimum:1
Maximum:10
password_max_minutes
Type:integer
Description:(For 'share' action) Auto-generated password expires after this many minutes (1-10). Leave empty for no expiration
Minimum:1
Maximum:10
metadata
Type:object
Description:(For 'update_metadata' action) New or updated metadata as key-value pairs. Will merge with existing metadata
add_tags
Type:array
Description:(For 'update_metadata' action) Tags to add to existing tags (preserves current tags)
Array items:string
remove_tags
Type:array
Description:(For 'update_metadata' action) Tags to remove from existing tags
Array items:string

API Example

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -H "X-Budget-Key: your-budget-key-here" \
  -d '{
    "product_id": "6948b078b54506f955d789ed",
    "parameters": {
      "action": "get_instructions",
      "limit": 50,
      "url_expiration_minutes": 60
    }
  }'

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

About The Developer

Apoth3osis logo

Apoth3osis

13 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 by Apoth3osis | AgentPMT