{"uid":"cap_wiNYJIDYqo5XezPTc4rJN","slug":"stacktree-provision-provision-api-key-for-private-html-sharing-7ec55e75","name":"Stacktree /provision — Provision API Key for Private HTML Sharing","description":"Stacktree: provision a persistent API key for hosting HTML pages as private, shareable web pages ($1.00). The key is returned once in the response body.","url":"https://api.stacktr.ee/provision","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"ap2_mandate":{"type":"object","description":"AP2 rail: an AP2 mandate object."},"acp_shared_payment_token":{"type":"string","description":"ACP rail: a Stripe Shared Payment Token (spt_...)."}}},"responseSchema":{"type":"json","example":{"ok":true,"usage":"Authorization: Bearer stk_live_…","api_key":"stk_live_…"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EA53Rr_Ksl3Z_tiyMx1e9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Provisions a one-time-shown stk_live_ API key for Stacktree, which lets agents publish private, unguessable links to HTML content such as specs, PR writeups, and status reports.","exampleAgentPrompt":"I want to start publishing private HTML links with Stacktree — provision me a new stk_live_ API key so I can share specs and PR writeups as unguessable private links.","exampleUseCases":null,"resultDescription":"Returns a JSON object with ok: true, a one-time-shown stk_live_ API key (api_key), a usage hint showing how to set the Authorization: Bearer header, the key prefix, and the protocol name.","failureModes":["Payment not settled or invalid x402 signature — no key returned","ACP shared payment token malformed (must start with spt_) — 400 error","AP2 mandate object invalid or missing required fields — provisioning fails","Duplicate or replayed payment — rejected to prevent double-provisioning","Network timeout before payment confirmation — key not issued, must retry"],"whenToPreferThis":"Use this endpoint when an AI agent needs to provision a fresh Stacktree API key before it can publish private HTML content (specs, reports, custom editors). This is the gateway/auth step — call this once before using other Stacktree endpoints. Choose this over alternatives when you need MCP-native, private-by-default HTML link sharing with replace-in-place capabilities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:32:24.569Z","isFirstParty":false}