run402

Provision a new Postgres database. Returns project credentials on success, or payment details if x402 payment is needed.

Execute SQL (DDL or queries) against a provisioned project. Returns results as a markdown table.

Query or mutate data via the PostgREST REST API. Supports GET/POST/PATCH/DELETE with query params.

Apply row-level security to tables. Templates: user_owns_rows (users access own rows only), public_read (anyone reads, authenticated writes), public_read_write (open access).

Introspect the database schema — tables, columns, types, constraints, and RLS policies. Useful for understanding the database structure before writing queries.

Get project usage report — API calls, storage usage, limits, and lease expiry.

Upload text content to project storage. Returns the storage key and size.

Download a file from project storage. Returns the file content.

Delete a file from project storage.

List files in a storage bucket. Shows file names, sizes, and last modified dates.

Deploy a serverless function (Node 22) to a project. Handler signature: export default async (req: Request) => Response. Pre-bundled packages: stripe, openai, @anthropic-ai/sdk, resend, zod, uuid, jsonwebtoken, bcryptjs, cheerio, csv-parse.

Invoke a deployed function via HTTP. Returns the function's response body and status code. Useful for testing functions without building a frontend.

Get recent logs from a deployed function. Shows console.log/error output and error stack traces from CloudWatch.

List all deployed functions for a project. Shows names, URLs, runtime, timeout, and memory.

Delete a deployed function from a project.

Set a project secret (e.g. STRIPE_SECRET_KEY). Secrets are injected as process.env variables in functions. Setting an existing key overwrites it.

List secret keys for a project (values are not shown). Useful for checking which secrets are configured.

Delete a secret from a project.

Deploy a static site (HTML/CSS/JS). Files are uploaded to S3 and served via CloudFront at a unique URL. Costs $0.05 USDC via x402.

Claim a custom subdomain (e.g. myapp.run402.com) and point it at an existing deployment. Free, requires service_key auth.

Release a custom subdomain. The URL will stop serving content.

List all subdomains claimed by a project.

One-call full-stack app deployment. Provisions a database and optionally runs migrations, applies RLS, sets secrets, deploys functions, deploys a static site, and claims a subdomain — all in a single x402 payment.

Browse public apps available for forking. Optionally filter by tags.

Fork a published app into a new project. Creates a full copy including database, functions, site, and optionally claims a subdomain.

Publish a project as a forkable app. Set visibility and tags for discoverability.

List published versions of a project.

Get tier pricing for Run402 projects. Free, no auth required. Shows prices, lease durations, storage limits, and API call limits.

Renew a project's lease. Returns success or payment details if x402 payment is needed.

Archive a project and remove it from the local key store. This action cannot be undone.

Check billing account balance for a wallet address. Shows available and held funds.

List all active projects for a wallet address.

Check local wallet status — address, network, and funding status.

Create a new local wallet (Base Sepolia testnet). Generates a private key and derives the Ethereum address. Saved to ~/.config/run402/wallet.json.

Export the local wallet address. Safe to share publicly.

Request free testnet USDC from the Run402 faucet (Base Sepolia). Rate limit: 1 per IP per 24h. Returns 0.25 USDC — enough for 2 prototype databases.

Generate a PNG image from a text prompt. Costs $0.03 USDC via x402. Aspect ratios: square (1:1), landscape (16:9), portrait (9:16).