Skip to content
onelayer.
All tools

Tool detail

StableUpload

Buys a file-upload slot and returns a URL to upload a file to, yielding a public download link for 6 months or 7 days.

Categories: Data storage

Use when

  • get a public URL to host a file an agent produced
  • upload an image or video for temporary or 6-month hosting

Not for

  • not the upload itself — this call only mints the upload session/URL

Inputs

POST JSON body: filename (string, required), contentType (MIME type string, required), tier (enum size/duration, required), policyTtlSeconds (integer 60–86400, optional)

Admitted input schema

{
  "type": "object",
  "properties": {
    "contentType": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "MIME type of the file (e.g. image/png, video/mp4)"
    },
    "filename": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Name of the file to upload"
    },
    "policyTtlSeconds": {
      "type": "integer",
      "minimum": 60,
      "maximum": 86400,
      "description": "Optional upload URL/form expiration in seconds, 60-86400. Use longer TTLs only when reserving an output slot for a downstream service."
    },
    "tier": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "10mb",
        "100mb",
        "1gb",
        "short-10mb",
        "short-100mb",
        "short-1gb",
        "short-5gb"
      ],
      "description": "Upload tier. Default 6-month tiers: 10mb ($0.02), 100mb ($0.20), 1gb ($2.00). Short-term 7-day workflow tiers: short-10mb ($0.005), short-100mb ($0.02), short-1gb ($0.10), short-5gb ($0.50, file uploads only)."
    }
  },
  "required": [
    "filename",
    "contentType",
    "tier"
  ],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://stableupload.dev/api/upload

Payment

Protocol
x402
Listed price
Tier-dependent on Base: 0.005 USDC (short-10mb) up to 2 USDC (1gb/6-month)
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://stableupload.dev/api/upload
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z