File Management

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.

AgentPMT@agentpmt

Install

openclaw skills install @agentpmt/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:

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.

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

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: upload-large): 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: 20 credits. Parameters: content_length_bytes, content_type, expiration_days, filename, metadata, password_max_minutes, password_max_uses, shared, plus 1 more.
upload_standard (action slug: upload-standard): 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. Price: 10 credits. Parameters: content_length_bytes, content_type, expiration_days, filename, metadata, password_max_minutes, password_max_uses, shared, 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:

json

{
  "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:

json

{
  "action": "get_instructions",
  "tool_id": "file-management"
}

Authenticated AgentPMT REST schema lookup body:

json

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_schema",
    "tool_id": "file-management"
  }
}

Authenticated AgentPMT REST live examples body:

json

{
  "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
- ClawHub page: https://clawhub.ai/agentpmt/what-is-agentpmt
- OpenClaw install: openclaw skills install what-is-agentpmt
- skills.sh install: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup
- ClawHub page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup
- OpenClaw install: openclaw skills install agentpmt-account-mcp-rest-api-setup
- skills.sh install: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup
No-account AgentAddress/x402 setup: ../agentpmt-no-account-agentaddress-x402
- ClawHub page: https://clawhub.ai/agentpmt/agentpmt-no-account-agentaddress-x402
- OpenClaw install: openclaw skills install agentpmt-no-account-agentaddress-x402
- skills.sh install: npx skills add AgentPMT/agent-skills --skill agentpmt-no-account-agentaddress-x402

skills.sh install script:

bash

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:

json

{
  "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:

json

{
  "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

What AgentPMT is: ../what-is-agentpmt (ClawHub: what-is-agentpmt, page: https://clawhub.ai/agentpmt/what-is-agentpmt; skills.sh: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt)
AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup (ClawHub: agentpmt-account-mcp-rest-api-setup, page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup; skills.sh: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup)
No-account AgentAddress/x402 setup: ../agentpmt-no-account-agentaddress-x402 (ClawHub: agentpmt-no-account-agentaddress-x402, page: https://clawhub.ai/agentpmt/agentpmt-no-account-agentaddress-x402; skills.sh: npx skills add AgentPMT/agent-skills --skill agentpmt-no-account-agentaddress-x402)
Marketplace product: https://www.agentpmt.com/marketplace/file-management
AgentPMT main MCP server: https://api.agentpmt.com/mcp/
AgentPMT REST invoke endpoint: https://api.agentpmt.com/products/purchase

File Management

Install

File Management

Freshness

What This Tool Does

Product Instructions

File Management

Actions

upload_standard

upload_large

list

get

download

delete

share

access_history

update_metadata

extend_expiration

Notes

When To Use

Use Cases

Related Product Skills

Categories And Industries

Actions And Schema

Live Schema And Examples

Call This Tool

Response Handling

Security

AgentPMT Reference

`upload_standard`

`upload_large`

`list`

`get`

`download`

`delete`

`share`

`access_history`

`update_metadata`

`extend_expiration`