| name | file-management |
| description | File Management: Upload and manage files in one tool: upload_standard, upload_large, list with previews, get signed URLs, download, delete, share, update metadata, inspect access history, and extend expiration. Use when an agent needs file management, small file upload, large file upload, signed upload url generation, temporary file hosting, access history, file id, limit through AgentPMT-hosted remote tool calls. Discovery terms: file management, small file upload, large file upload. |
| version | 1.0.1 |
| homepage | https://www.agentpmt.com/marketplace/file-management |
| compatibility | Agent instructions for AgentPMT-hosted remote tool calls. Follow this skill body for supported account, wallet, and setup routes. No local command runtime is declared. |
| metadata | {"author":"agentpmt","openclaw":{"homepage":"https://www.agentpmt.com/marketplace/file-management"}} |
File Management
Freshness
Last updated: 2026-07-20.
If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples.
What This Tool Does
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.
Product Instructions
File Management
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:
filenamecontent_typeexpiration_days (1-7)sharedpassword_max_uses (1-10)password_max_minutes (1-10)metadatatags
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:
filenamecontent_typeexpiration_days (1-7)sharedpassword_max_uses (1-10)password_max_minutes (1-10)metadatatags
list
List active files for the current budget. Results are newest first and include preview URLs when available.
Optional fields:
tagsdate_fromdate_tolimitoffseturl_expiration_minutes
get
Get metadata and a fresh signed download URL for a file.
Required fields:
Optional fields:
download
Download base64 content for files up to 5MB, or get a signed URL for larger files.
Required fields:
Optional fields:
return_contenturl_expiration_minutes
delete
Delete a file permanently.
Required fields:
share
Create or refresh a password-protected public share link.
Required fields:
Optional fields:
password_max_usespassword_max_minutes
access_history
View share access history for a file.
Required fields:
Optional fields:
update_metadata
Update metadata and tags on a file.
Required fields:
Optional fields:
metadatatagsadd_tagsremove_tags
extend_expiration
Extend expiration by 7 days.
Required fields:
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.
When To Use
- Use this skill for
File Management on AgentPMT.
- Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape.
- Search and activation keywords: file management, small file upload, large file upload, signed upload url generation, temporary file hosting, access history, file id, limit.
- Supported action names:
access_history, delete, download, extend_expiration, get, list, share, update_metadata, upload_large, upload_standard.
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
Related Product Skills
Categories And Industries
No categories or industry tags are published for this tool.
Actions And Schema
Complete generated action schema: ./schema.md.
Supported action count: 10.
x402 action routes are enabled and listed in ./schema.md.
access_history (action slug: access-history): View password-protected share access history for a file. Price: 0 credits. Parameters: file_id, limit.delete (action slug: delete): Permanently delete a file from storage. Price: 0 credits. Parameters: file_id.download (action slug: download): Download file content as base64 for files up to 5MB, or return a signed URL for larger files. Price: 0 credits. Parameters: file_id, return_content, url_expiration_minutes.extend_expiration (action slug: extend-expiration): Extend a file's expiration date by 7 days from the current expiration. Price: 10 credits. Parameters: file_id.get (action slug: get): Get file metadata and a fresh signed download URL for a specific file. Price: 0 credits. Parameters: file_id, url_expiration_minutes.list (action slug: list): List active uploaded files for the current budget with optional filtering and pagination. Returns newest files first and includes cached preview URLs when available. Price: 0 credits. Parameters: date_from, date_to, limit, offset, tags, url_expiration_minutes.share (action slug: share): Create or refresh a password-protected public share link for an existing file. Price: 5 credits. Parameters: file_id, password_max_minutes, password_max_uses.update_metadata (action slug: update-metadata): Update metadata and tags on a file. Price: 5 credits. Parameters: add_tags, file_id, metadata, remove_tags, tags.upload_large (action slug: ): 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. Price: credits. Parameters: , , , , , , , , plus 1 more.
Live Schema And Examples
Use the compact schema above for ordinary calls. Before a new production integration, or whenever parameters, enum values, nested objects, outputs, or examples are unclear, fetch live details first.
- Exact schema: call
agentpmt-tool-search-and-execution with action: "get_schema", and tool_id: "file-management".
- Detailed examples: call
agentpmt-tool-search-and-execution with action: "get_instructions" and tool_id: "file-management", or call this product with action: "get_instructions" when the product tool is already selected.
- Treat returned live schema and instructions as more specific than this generated summary.
MCP schema lookup through the main AgentPMT MCP server:
{
"method": "tools/call",
"params": {
"name": "AgentPMT-Tool-Search-and-Execution",
"arguments": {
"action": "get_schema",
"tool_id": "file-management"
}
}
}
For live examples, keep the same MCP tool and use these arguments:
{
"action": "get_instructions",
"tool_id": "file-management"
}
Authenticated AgentPMT REST schema lookup body:
{
"name": "agentpmt-tool-search-and-execution",
"parameters": {
"action": "get_schema",
"tool_id": "file-management"
}
}
Authenticated AgentPMT REST live examples body:
{
"name": "agentpmt-tool-search-and-execution",
"parameters": {
"action": "get_instructions",
"tool_id": "file-management"
}
}
Call This Tool
Product slug: file-management
Marketplace page: https://www.agentpmt.com/marketplace/file-management
- AgentPMT account route: first use
../agentpmt-account-mcp-rest-api-setup to connect the main MCP server or REST API for an Agent Group where this tool is enabled.
- No-account AgentAddress/x402 route: first use
../agentpmt-no-account-agentaddress-x402 for the canonical payment and wallet setup instructions.
- AgentPMT overview: use
../what-is-agentpmt for marketplace, Agent Group, workflow, MCP, REST, and payment concepts.
If those setup skills are not installed beside this product skill, use the downloads below.
Core AgentPMT setup skills:
- What AgentPMT is: ../what-is-agentpmt
- AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup
- No-account AgentAddress/x402 setup: ../agentpmt-no-account-agentaddress-x402
skills.sh install script:
npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup
npx skills add AgentPMT/agent-skills --skill agentpmt-no-account-agentaddress-x402
MCP call shape after the main AgentPMT MCP server is connected:
{
"method": "tools/call",
"params": {
"name": "File-Management",
"arguments": {
"action": "access_history",
"file_id": "example file id",
"limit": 1
}
}
}
Use the exact tool name returned by tools/list; the name above is the expected readable form.
Authenticated AgentPMT REST call body:
{
"name": "file-management",
"parameters": {
"action": "access_history",
"file_id": "example file id",
"limit": 1
}
}
Use the setup skill for the account connection details before making REST calls.
Response Handling
- Treat the returned JSON as the source of truth for this tool call.
- If the response includes warnings or correction targets, apply them before retrying.
- If the response includes a
passed or success-style boolean, use it as the workflow gate.
- If validation fails or the response shape is unclear, call
get_schema or get_instructions before retrying.
- If
access_history fails, preserve the request parameters and retry only after fixing schema, auth, or payment errors.
Security
- Do not place account secrets, wallet private keys, mnemonics, signatures, or payment headers in prompts or logs.
- Keep tool inputs scoped to the minimum content needed for the task.
- Use the setup skills for credential handling; this product skill only defines product-specific behavior.
AgentPMT Reference
