File Management by Apoth3osis

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

File Management

Storage

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

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.

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

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.

Usage Instructions

Usage guidance provided directly by the developer for this product.

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.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

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

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 6948b078b54506f955d789ed ("File Management"). Then call the same tool with action 'call_tool', tool_id 6948b078b54506f955d789ed, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.