Provision

Host generated HTML as a shareable web page (turn any HTML into a webpage): POST HTML + payment, get back a permanent private link.

Agent-native, no human and no account. POST your HTML with no payment to receive a 402 carrying x402 (PAYMENT-REQUIRED header) and MPP-evm (WWW-Authenticate: Payment) requirements. Pay $0.50 in USDC on Base (accepts[0]) or on Solana (accepts[1]) and retry with the same body; on settlement the page publishes to a permanent, unguessable link and you get back the URL plus a one-time claim token. The entry rung of the agentic ladder — vs $1 for a reusable key via /provision. Settled through the Coinbase CDP facilitator. Read the accepts array from the 402 rather than hardcoding a rail: the requirements differ per network (an EIP-712 domain on Base, a sponsoring feePayer on Solana), and free keyless revisions afterwards are EVM-only.

post/publish

Request

  • Base URL: https://api.stacktr.ee
  • URL: https://api.stacktr.ee/publish
  • Auth: none required

Request body

htmlstring required

The full HTML document to host.

filenamestring

Optional logical filename; defaults to index.html.

Response

Paid and published. Returns the permanent URL + the claim token. The claim token adopts the page into an account, and until it is used for that it is also the page's keyless update credential: PUT /sites/{id} with Authorization: Claim <claim_token> replaces the content at the same URL, on Base and Solana alike, with no account and no signature. The next.update_in_place hint in the response body carries the exact request.

urlstring
unlisted_tokenstring
claim_tokenstring
expires_atinteger nullable

null: the payment bought permanence outright, outside the plan ladder.

expires_at_isostring nullable
ttl_secondsinteger nullable
expiry_clampedboolean

Always false on this rail: a paid one-off page has no plan ceiling to be clamped by.

expiry_ceiling_hoursinteger nullable
expiry_sourcestring

Changes

No recorded changes to this operation across all 1 revision of this API.