Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Run402 Storage API
version: 2.0.0
description: 'Full-stack infrastructure for AI agents. Postgres, REST API, auth, file storage, static site hosting, serverless functions. Tier payments and image generation use the shared payment engine: x402 (USDC on Base), MPP on Tempo (pathUSD), and the draft-pinned MPP Lightning charge profile (sats, Bitcoin mainnet) for authenticated tier purchases and image generation.'
contact:
name: Run402
url: https://run402.com
guidance: 'Run402 is a pay-per-use backend for AI agents: Postgres databases, static hosting, serverless functions, and image generation. The shared payment engine supports x402 (USDC on Base), MPP on Tempo (pathUSD), and the exact Run402 MPP Lightning charge profile on Bitcoin mainnet (sats).
## Quick start
1. Install the CLI: npm install -g run402@latest
2. Create an allowance: run402 init
3. Set the prototype tier (FREE, testnet USDC): run402 tier set prototype
4. Provision a project: run402 projects provision --name "my-app"
5. Deploy: run402 deploy --manifest app.json
## Payment model
- Tiers (prototype $0.10 testnet, hobby $5, team $20; hobby and team are 30-day prepaid leases) unlock all platform features.
- Image generation is $0.03 per call (x402, MPP on Tempo, or MPP Lightning micropayment).
- Auth-only endpoints (projects, deploys, messages) require SIWX wallet identity but no payment.
## Auth
- x402 endpoints: include a payment header (handled automatically by the CLI or x402 client libraries).
- Explicit MPP Lightning tier requests require the exact Run402 profile, ordered Accept-Payment preferences, one principal credential, a stable Idempotency-Key, and buyer-side USD/native/fee limits.
- SIWX endpoints: sign a CAIP-122 message with your wallet.
- REST API: use the project''s anon_key or service_key as the apikey header.
## Client metadata
- Recent Node SDK/CLI clients may send Run402-Client: surface="cli", version="3.7.14", sdk="3.7.14". It is advisory, bounded, never used for auth/billing/trust, and not browser-CORS-enabled yet.
## Docs
- Full CLI docs: https://run402.com/llms-cli.txt
- API docs: https://run402.com/llms.txt'
servers:
- url: https://api.run402.com
description: Production
tags:
# --- truncated at 32 KB (42 KB total) ---
# Full source: https://artifacts.apis.io/run402-com/openapi/run402-com-storage-api-openapi.yml