project and link it as the settlement wallet"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 16b:["Get all projects"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 16c:["Get a single project"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 16d:["Get the project settlement wallet (default / dedicated / account / nwc / provider)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 16e:["Get project statistics"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 16f:["Invite a member by email (owner only)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 170:["List project members (viewer+)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 171:["My pending invitations (accept/decline here)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 172:["Projects shared with me (I am a member)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 173:["Delete a project"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 174:["Revoke membership or decline an invitation"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 175:["Link the settlement wallet: 'default' | 'account:' | 'nwc:' | 'provider:' (legacy)"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 176:["Update a project"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 177:["Change a member role (owner only)"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 178:["Create a new provider connection"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 179:["Disconnect provider"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 17a:["Get all providers"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 17b:["Get a single provider"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 17c:["Delete a provider"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 17d:["Test provider connection"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 17e:["Public SSE stream for one invoice (paymentHash capability)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 17f:["SSE stream of the authenticated user’s realtime events"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 180:["Create a refund for a paid invoice"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 181:["List all refunds (merchant)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 182:["List refunds for an invoice"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 183:["Relay allowlist check — is this pubkey a current member? (called by relay auth plugins)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 184:["Buyer checks if their payment settled"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 185:["Create a relay access pass"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 186:["Issue an invoice for a buyer pubkey (public)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 187:["List my relay passes"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 188:["Relay pass detail"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 189:["Public pass view (title, price, relay)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 18a:["Recent buyer grants for this pass"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 18b:["Delete a relay pass"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 18c:["Enable/disable a relay pass"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 18d:["Delete the scrub rule"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 18e:["Get my scrub rule (null when none)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 18f:["Forward history (audit trail)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 190:["Create or replace the scrub rule"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 191:["Global dashboard search"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 192:["Delete the split rule for a project"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 193:["Get the split rule for a project"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 194:["Split payout history for a project"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 195:["Create or replace the split rule for a project"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 196:["Cancel via magic link"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 197:["Disable NWC auto-pay"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 198:["Enable NWC auto-pay (subscriber wallet connection)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 199:["Subscriber portal (magic link)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 19a:["Public plan detail (checkout page)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 19b:["Pause renewals via magic link"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 19c:["Resume via magic link"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 19d:["Subscribe to a plan (public checkout)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 19e:["Cancel a subscription (owner action)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 19f:["List subscribers of a project"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1a0:["Project MRR/ARR in sats"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1a1:["Reverse swap — deposit on-chain BTC into your wallet"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1a2:["Submarine swap — withdraw sats to a Bitcoin address"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1a3:["List my swaps"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1a4:["Swap detail"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1a5:["Swap availability, limits and fees"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1a6:["Poll the Boltz status and update the swap"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1a7:["Add a charge or credit to the tab"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1a8:["Archive a tab"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 1a9:["Cancel a pending settlement"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 1aa:["Settlement confirmation check (public)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ab:["Open a tab"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1ac:["Pay (part of) the tab balance (public)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1ad:["List my tabs"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ae:["Tab detail (owner)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1af:["Public tab view — balance + recent entries"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1b0:["Tab entries (owner)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1b1:["Tab settlements (owner)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1b2:["Close or reopen a tab"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 1b3:["Delete a blob by URL"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 1b4:["Blob credential status (diagnostic — no secrets exposed)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1b5:["Mint client-upload token (used by @vercel/blob/client)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1b6:["Upload an image through the server (≤5 MB)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1b7:["Get current quota usage"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1b8:["Get usage statistics"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1b9:["Bulk activate users"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1ba:["Bulk deactivate users"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1bb:["Bulk delete users"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 1bc:["Create a new user (Admin only)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1bd:["Get all users with pagination (Admin/Moderator)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1be:["Get a user by ID"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1bf:["Get user statistics (Admin/Moderator)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1c0:["Delete a user"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 1c1:["Advanced search for users"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1c2:["Update a user"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 1c3:["Check payment status"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1c4:["Convert fiat to sats or vice versa"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1c5:["Create a new account (user + wallet) for other users"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1c6:["Create invoice (receive sats)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1c7:["Create a new wallet"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1c8:["Decode a BOLT11 invoice"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1c9:["Generate QR code for arbitrary data"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ca:["List available currencies"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1cb:["Get exchange rate for a currency"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1cc:["Get wallet payments"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1cd:["Get payments history for charts"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ce:["Get wallet info and balance"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1cf:["List all wallets of the user"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1d0:["Scan/decode an LNURL or lightning address"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d1:["Pay a BOLT11 invoice (send sats)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d2:["Pay an LNURL or lightning address"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d3:["Build a PSBT spending to a destination (p2wpkh wallets)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d4:["List my watch-only wallets"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1d5:["Wallet detail"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1d6:["Fresh receive address (reuses the newest unused one, else derives next)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d7:["Import an xpub (watch-only wallet)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1d8:["List derived addresses (with balances)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1d9:["Refresh balances from mempool.space"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1da:["Delete a watch-only wallet"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 1db:["Create a new webhook endpoint"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1dc:["Delivery status counts for dashboard stat cards"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1dd:["Export webhook deliveries as CSV"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1de:["Get all webhooks"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1df:["List webhook deliveries (retry dashboard)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e0:["Get a single delivery (full payload + error)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e1:["Get a single webhook"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e2:["Delete a webhook"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 1e3:["Replay an event to all subscribed endpoints"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1e4:["Manually retry a delivery"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1e5:["Reveal the webhook signing secret"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e6:["Roll (rotate) the webhook signing secret"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1e7:["Test webhook delivery"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1e8:["Update webhook status"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 1e9:["Withdraw sats (BOLT11 / lightning address / LNURL)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 1ea:["Withdrawal history"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1eb:["Withdrawal detail (incl. preimage proof)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ec:["Current velocity-limit usage"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1ed:["$","$L20f",null,{"ref":"$undefined","icon":{"name":"rocket","size":24,"node":[["path",{"d":"M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5","key":"qeys4"}],["path",{"d":"M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91-.09","key":"u4xsad"}],["path",{"d":"M9 12a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.4 22.4 0 0 1-4 2z","key":"676m9"}],["path",{"d":"M9 12H4s.55-3.03 2-4c1.62-1.08 5 .05 5 .05","key":"92ym6u"}]]},"className":"size-4"}] 1ef:["$","$L20f",null,{"ref":"$undefined","icon":{"name":"book-open","size":24,"node":[["path",{"d":"M12 5v16","key":"1f6ucr"}],["path",{"d":"M20.001 19A2 2 0 0022 17V5a2 2 0 00-1.999-2L16 3.002A5 5 0 0012 5a5 5 0 00-4-2H4a2 2 0 00-2 2v12a2 2 0 001.999 2H8a5 5 0 014 2 5 5 0 014-2z","key":"1fyvmf"}]]},"className":"size-4"}] 1f1:["$","$L20f",null,{"ref":"$undefined","icon":{"name":"brain-circuit","size":24,"node":[["path",{"d":"M12 13h4","key":"1ku699"}],["path",{"d":"M12 18h6a2 2 0 012 2v1","key":"6s3bw4"}],["path",{"d":"M12 8h8","key":"1lhi5i"}],["path",{"d":"M12 9a4.17 4.17 0 01-3 4","key":"13l7kh"}],["path",{"d":"M16 8V5a2 2 0 012-2","key":"gais5y"}],["path",{"d":"M6 18a4 4 0 01-2-7.465","key":"1y2m15"}],["path",{"d":"M6.004 5.125a4 4 0 00-2.526 5.77","key":"3cw1ss"}],["path",{"d":"M6.294 6.294A3 3 0 1112 5v13a4 4 0 11-7.967-.518","key":"m2z1wm"}],["circle",{"cx":"16","cy":"13","r":"0.5","fill":"currentColor","key":"9zzywh"}],["circle",{"cx":"18","cy":"3","r":"0.5","fill":"currentColor","key":"i2xui6"}],["circle",{"cx":"20","cy":"21","r":"0.5","fill":"currentColor","key":"1dobdp"}],["circle",{"cx":"20","cy":"8","r":"0.5","fill":"currentColor","key":"r9nqlq"}]]},"className":"size-4"}] 1f3:["$","$L20f",null,{"ref":"$undefined","icon":{"name":"layers","size":24,"node":[["path",{"d":"M12.83 2.18a2 2 0 0 0-1.66 0L2.6 6.08a1 1 0 0 0 0 1.83l8.58 3.91a2 2 0 0 0 1.66 0l8.58-3.9a1 1 0 0 0 0-1.83z","key":"zw3jo"}],["path",{"d":"M2 12a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 12","key":"1wduqc"}],["path",{"d":"M2 17a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 17","key":"kqbvx6"}]],"aliases":["layers-3"]},"className":"size-4"}] 1f5:["$","$L20f",null,{"ref":"$undefined","icon":{"name":"zap","size":24,"node":[["path",{"d":"M15.914 4a1.5 1.5 0 00-2.474-1.561l-9 9A1.5 1.5 0 005.5 14h4.002a.5.5 0 01.471.666L8.086 20a1.5 1.5 0 002.475 1.56l9-9A1.5 1.5 0 0018.5 10h-3.997a.5.5 0 01-.472-.667z","key":"1v7up4"}]]},"className":"size-4"}] 1f7:["$","$L20f",null,{"ref":"$undefined","icon":{"name":"code-xml","size":24,"node":[["path",{"d":"m18 16 4-4-4-4","key":"1inbqp"}],["path",{"d":"m6 8-4 4 4 4","key":"15zrgr"}],["path",{"d":"m14.5 4-5 16","key":"e7oirm"}]],"aliases":["code-2"]},"className":"size-4"}] 1f9:["$","$L20f",null,{"ref":"$undefined","icon":{"name":"key-round","size":24,"node":[["path",{"d":"M2.586 17.414A2 2 0 0 0 2 18.828V21a1 1 0 0 0 1 1h3a1 1 0 0 0 1-1v-1a1 1 0 0 1 1-1h1a1 1 0 0 0 1-1v-1a1 1 0 0 1 1-1h.172a2 2 0 0 0 1.414-.586l.814-.814a6.5 6.5 0 1 0-4-4z","key":"1s6t7t"}],["circle",{"cx":"16.5","cy":"7.5","r":".5","fill":"currentColor","key":"w0ekpg"}]]},"className":"size-4"}] 1fb:["$","$L20f",null,{"ref":"$undefined","icon":{"name":"sparkles","size":24,"node":[["path",{"d":"M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z","key":"1s2grr"}],["path",{"d":"M20 2v4","key":"1rf3ol"}],["path",{"d":"M22 4h-4","key":"gwowj6"}],["circle",{"cx":"4","cy":"20","r":"2","key":"6kqj1y"}]],"aliases":["stars"]},"className":"size-4"}] 1fd:["$","span",null,{"className":"flex items-center gap-2 font-semibold","children":[["$","$L20f",null,{"ref":"$undefined","icon":"$1f5:props:icon","className":"size-5 text-yellow-500","aria-hidden":true}],"ZapAPI Docs"]}] 1fe:["$","$L6",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L7",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}] 200:["$","$1","c",{"children":[null,["$","$L6",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L7",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}] 203:["$","$1","c",{"children":["$L210",[["$","script","script-0",{"src":"/_next/static/immutable/chunks/3dnlfx6egoo9r.js","async":true,"nonce":"$undefined"}],["$","script","script-1",{"src":"/_next/static/immutable/chunks/1bd2qu74cohtf.js","async":true,"nonce":"$undefined"}],["$","script","script-2",{"src":"/_next/static/immutable/chunks/0uy5_0brdgyrh.js","async":true,"nonce":"$undefined"}]],["$","$L211",null,{"children":["$","$209",null,{"name":"Next.MetadataOutlet","children":"$@212"}]}]]}] 201:C 217:T8df, # ZapAPI — Lightning Payments API ## Overview Non-custodial Lightning payment infrastructure: invoices, payment links, Lightning addresses, subscriptions, zaps and webhooks — settled directly to your own LNbits/node, never held by ZapAPI. ## Features - ⚡ Lightning invoices (BOLT-11) with hosted checkout - 🔗 Payment links, Lightning addresses (LUD-06/16) & Nostr zaps - 👥 Creator subscriptions with recurring LNURL billing - 🔑 Scoped API keys (`zap_live_`/`zap_test_`) for server integrations - 📡 Signed webhooks with automatic retries, manual retry & event replay - 🛡️ JWT dashboard auth (access + refresh) alongside API keys - 🔄 API Versioning (URI & Header-based) ## Authentication Two auth schemes, both via the `Authorization` header: ### API keys (server-to-server) ``` Authorization: Bearer zap_live_your_key_here ``` Keys are scoped (e.g. `invoices:write`, `webhooks:read`) and prefixed `zap_live_` (production) or `zap_test_` (test mode). ### JWT (dashboard sessions) ``` Authorization: Bearer ``` - **Access Token**: 15 minutes expiry - **Refresh Token**: 7 days expiry - **Refresh Endpoint**: `POST /api/v1/auth/refresh` ## Response Envelope Every JSON response is wrapped: ```json { "status": "success", "statusCode": 200, "message": "Request successful", "data": {}, "timestamp": "2026-10-24T00:00:00.000Z", "path": "/api/v1/invoices" } ``` ## Error Handling Errors use the same envelope with `status: "error"`: ```json { "status": "error", "statusCode": 400, "message": "Error description", "errors": ["Detailed validation errors"], "timestamp": "2026-10-24T00:00:00.000Z", "path": "/api/v1/endpoint" } ``` ## API Versioning ### URI Versioning (Recommended) ``` GET /api/v1/users ``` ### Header Versioning ``` X-API-Version: 1 Accept-Version: 1 ``` ## Webhooks Outbound events are POSTed to your endpoints with Stripe-style signatures: `X-ZapAPI-Signature: t=,v1=`. Failed deliveries retry 5 times with exponential backoff; delivery history, manual retries and event replay are available via the `/api/v1/webhooks/deliveries` endpoints and the dashboard. ## Support - **Documentation**: [docs.zapapi.com](https://docs.zapapi.com) 210:["$","$L213",null,{"toc":[],"full":true,"children":[["$","script",null,{"type":"application/ld+json","dangerouslySetInnerHTML":{"__html":"{\"@context\":\"https://schema.org\",\"@type\":\"TechArticle\",\"headline\":\"Public bio-profile directory — boosted first, then newest\",\"url\":\"https://docs.zapapi.app/docs/api/bio-links/listProfiles\",\"image\":\"https://docs.zapapi.app/og/docs/api/bio-links/listProfiles/image.png\",\"author\":{\"@type\":\"Organization\",\"name\":\"ZapAPI Docs\"},\"publisher\":{\"@type\":\"Organization\",\"name\":\"ZapAPI Docs\"},\"isPartOf\":{\"@type\":\"WebSite\",\"name\":\"ZapAPI Docs\",\"url\":\"https://docs.zapapi.app\"}}"}}],["$","$L214",null,{"children":"Public bio-profile directory — boosted first, then newest"}],["$","$L215",null,{"children":["$","$L216",null,{"payload":{"bundled":{"openapi":"3.2.0","paths":{"/":{"get":{"operationId":"getHello","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"API is running"}},"summary":"Health check endpoint","tags":["health"]}},"/favicon.ico":{"get":{"operationId":"getFavicon","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"204":{"description":"No favicon available"}},"summary":"Favicon endpoint","tags":["health"]}},"/api/v1/admin/request-logs":{"get":{"operationId":"getRequestLogs","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/admin/request-logs"}]}}}}},"security":[{"bearer":[]}],"summary":"Get all request logs","tags":["Request Logs"]}},"/api/v1/admin/request-logs/user":{"get":{"operationId":"getUserRequestLogs","parameters":[{"name":"userId","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/admin/request-logs/user"}]}}}}},"security":[{"bearer":[]}],"summary":"Get request logs for specific user","tags":["Request Logs"]}},"/api/v1/admin/request-logs/statistics":{"get":{"operationId":"getStatistics","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/admin/request-logs/statistics"}]}}}}},"security":[{"bearer":[]}],"summary":"Get request log statistics","tags":["Request Logs"]}},"/api/v1/admin/request-logs/cleanup/stats":{"get":{"operationId":"getCleanupStats","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/admin/request-logs/cleanup/stats"}]}}}}},"security":[{"bearer":[]}],"summary":"Get cleanup statistics","tags":["Request Logs"]}},"/api/v1/admin/request-logs/cleanup/trigger":{"post":{"operationId":"triggerCleanup","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerCleanupDto"}}}},"responses":{"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/admin/request-logs/cleanup/trigger"}]}}}},"403":{"description":"Forbidden - Insufficient permissions.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":403,"message":"Forbidden resource","timestamp":"2026-01-31T19:20:00.000Z","path":"/admin/request-logs/cleanup/trigger"}]}}}},"500":{"description":"Internal Server Error - Unexpected error occurred.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":500,"message":"Internal server error","timestamp":"2026-01-31T19:20:00.000Z","path":"/admin/request-logs/cleanup/trigger"}]}}}}},"security":[{"bearer":[]}],"summary":"Manually trigger log cleanup","tags":["Request Logs"]}},"/api/v1/realtime/stream":{"get":{"operationId":"streamUser","parameters":[{"name":"token","required":false,"in":"query","description":"JWT (EventSource)","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"SSE stream of the authenticated user’s realtime events","tags":["realtime"]}},"/api/v1/realtime/stream/invoice/{paymentHash}":{"get":{"operationId":"streamInvoice","parameters":[{"name":"paymentHash","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Public SSE stream for one invoice (paymentHash capability)","tags":["realtime"]}},"/api/v1/search":{"get":{"description":"Fans out across invoices, payments, payment links, bio pages, customers, webhooks and lightning addresses in parallel. Always scoped to the caller.","operationId":"search","parameters":[{"name":"q","required":true,"in":"query","description":"Search query (min 2 chars)","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Global dashboard search","tags":["search"]}},"/api/v1/cron/reconcile-payments":{"get":{"operationId":"reconcile","parameters":[{"name":"authorization","required":true,"in":"header","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Sweep stale pending invoices and settle paid ones (Vercel Cron)","tags":["cron"]}},"/api/v1/cron/run":{"get":{"operationId":"run","parameters":[{"name":"authorization","required":true,"in":"header","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Run all due scheduled sweeps (Vercel Cron — every minute)","tags":["cron"]}},"/api/v1/auth/register":{"post":{"description":"Creates a new user account and sends email verification link. Rate limited to 5 requests per minute.","operationId":"register","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterDto"}}}},"responses":{"201":{"description":"User registered successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":201,"message":"Registration successful. Please check your email to verify your account.","data":{"user":{"id":"123e4567-e89b-12d3-a456-426614174000","email":"john.doe@example.com","firstName":"John","lastName":"Doe","isActive":true,"isEmailVerified":false,"createdAt":"2026-01-31T10:00:00.000Z","updatedAt":"2026-01-31T10:00:00.000Z"},"accessToken":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","refreshToken":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},"meta":{"user_id":"123e4567-e89b-12d3-a456-426614174000","created_at":"2026-01-31T10:00:00.000Z","email_verification_required":true},"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/register"}]}}}},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/auth/register"}]}}}},"409":{"description":"Conflict - Resource already exists.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":409,"message":"User with this email already exists","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/auth/register"}]}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":429,"message":"ThrottlerException: Too Many Requests","timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/register"}]}}}}},"summary":"Register a new user","tags":["auth"]}},"/api/v1/auth/login":{"post":{"description":"Authenticate user with email and password. Rate limited to 10 requests per minute.","operationId":"login","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginDto"}}}},"responses":{"200":{"description":"Login successful","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Login successful","data":{"user":{"id":"123e4567-e89b-12d3-a456-426614174000","email":"john.doe@example.com","firstName":"John","lastName":"Doe","isActive":true,"isEmailVerified":true,"createdAt":"2026-01-31T10:00:00.000Z","updatedAt":"2026-01-31T10:00:00.000Z"},"accessToken":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","refreshToken":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},"meta":{"user_id":"123e4567-e89b-12d3-a456-426614174000","is_email_verified":true},"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/login"}]}}}},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/auth/login"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/auth/login"}]}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":429,"message":"ThrottlerException: Too Many Requests","timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/login"}]}}}}},"summary":"Login user","tags":["auth"]}},"/api/v1/auth/nostr/challenge":{"get":{"description":"Issues a single-use challenge for a pubkey (npub or hex). Sign a kind 27235 event with tags [\"challenge\", c] and [\"expires\", unix] and POST it to /auth/nostr.","operationId":"nostrChallenge","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Get a nostr login challenge","tags":["auth"]}},"/api/v1/auth/nostr":{"post":{"description":"Verify a signed kind 27235 login event. Resolves the account from linked identities/wallet/addresses, or auto-provisions a new nostr-first user.","operationId":"nostrLogin","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"summary":"Login with nostr (passwordless)","tags":["auth"]}},"/api/v1/auth/nostr/nsec":{"post":{"description":"For users without a browser signer. The key signs a login event server-side and is never stored or logged. Auto-provisions new keys.","operationId":"nostrNsecLogin","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"summary":"Login with an nsec (private key)","tags":["auth"]}},"/api/v1/auth/logout":{"post":{"description":"Blacklists the current access token and revokes all refresh tokens","operationId":"logout","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Logout successful","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Logout successful","data":null,"meta":{"user_id":"123e4567-e89b-12d3-a456-426614174000","logged_out_at":"2026-01-31T10:00:00.000Z"},"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/logout"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/auth/logout"}]}}}}},"security":[{"bearer":[]}],"summary":"Logout user","tags":["auth"]}},"/api/v1/auth/refresh":{"post":{"description":"Get a new access token using a valid refresh token. Rate limited to 20 requests per minute.","operationId":"refreshToken","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshTokenDto"}}}},"responses":{"200":{"description":"Token refreshed successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Token refreshed successfully","data":{"accessToken":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","refreshToken":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},"meta":{"user_id":"123e4567-e89b-12d3-a456-426614174000","refreshed_at":"2026-01-31T10:00:00.000Z"},"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/refresh"}]}}}},"401":{"description":"Invalid or expired refresh token"}},"summary":"Refresh access token","tags":["auth"]}},"/api/v1/auth/forgot-password":{"post":{"description":"Sends password reset link to user email. Rate limited to 3 requests per hour.","operationId":"forgotPassword","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordDto"}}}},"responses":{"200":{"description":"Password reset email sent","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"If an account with that email exists, a password reset link has been sent.","data":null,"meta":{"email_sent_at":"2026-01-31T10:00:00.000Z"},"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/forgot-password"}]}}}}},"summary":"Request password reset","tags":["auth"]}},"/api/v1/auth/reset-password":{"post":{"description":"Reset password using token from email. Rate limited to 5 requests per hour.","operationId":"resetPassword","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordDto"}}}},"responses":{"200":{"description":"Password reset successful","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Password reset successful. Please login with your new password.","data":null,"meta":{"user_id":"123e4567-e89b-12d3-a456-426614174000","password_reset_at":"2026-01-31T10:00:00.000Z"},"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/reset-password"}]}}}},"400":{"description":"Invalid or expired reset token"}},"summary":"Reset password","tags":["auth"]}},"/api/v1/auth/verify-email":{"post":{"description":"Verify user email using token from email. Rate limited to 5 requests per hour.","operationId":"verifyEmail","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailDto"}}}},"responses":{"200":{"description":"Email verified successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Email verified successfully","data":null,"meta":{"user_id":"123e4567-e89b-12d3-a456-426614174000","verified_at":"2026-01-31T10:00:00.000Z"},"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/verify-email"}]}}}},"400":{"description":"Invalid or expired verification token"}},"summary":"Verify email","tags":["auth"]}},"/api/v1/auth/resend-verification":{"post":{"description":"Sends a new email verification link. Rate limited to 3 requests per hour.","operationId":"resendVerification","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Verification email sent","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Verification email sent successfully","data":null,"meta":{"email_sent_at":"2026-01-31T10:00:00.000Z"},"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/resend-verification"}]}}}}},"security":[{"bearer":[]}],"summary":"Resend email verification","tags":["auth"]}},"/api/v1/auth/me":{"get":{"description":"Returns the authenticated user profile","operationId":"getCurrentUser","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"User profile retrieved","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"User profile retrieved successfully","data":{"id":"123e4567-e89b-12d3-a456-426614174000","email":"john.doe@example.com"},"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/me"}]}}}}},"security":[{"bearer":[]}],"summary":"Get current user","tags":["auth"]}},"/api/v1/auth/sessions":{"get":{"operationId":"getSessions","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"List of active sessions retrieved successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Sessions retrieved successfully","data":[{"id":"123e4567-e89b-12d3-a456-426614174000","deviceName":"Chrome on macOS","deviceType":"desktop","ipAddress":"192.168.1.1","lastActivityAt":"2026-01-31T10:00:00.000Z","createdAt":"2026-01-31T09:00:00.000Z","expiresAt":"2026-02-07T09:00:00.000Z","isCurrent":true}],"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/sessions"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/auth/sessions"}]}}}}},"security":[{"bearer":[]}],"summary":"Get all active sessions","tags":["auth"]}},"/api/v1/auth/sessions/revoke":{"delete":{"operationId":"revokeSession","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokeSessionDto"}}}},"responses":{"200":{"description":"Session revoked successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Session revoked successfully","timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/sessions/revoke"}]}}}},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/auth/sessions/revoke"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/auth/sessions/revoke"}]}}}}},"security":[{"bearer":[]}],"summary":"Revoke a specific session","tags":["auth"]}},"/api/v1/auth/sessions/revoke-others":{"delete":{"operationId":"revokeOtherSessions","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokeOtherSessionsDto"}}}},"responses":{"200":{"description":"Other sessions revoked successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"All other sessions revoked successfully","data":{"revoked_count":3},"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/sessions/revoke-others"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/auth/sessions/revoke-others"}]}}}}},"security":[{"bearer":[]}],"summary":"Revoke all other sessions","tags":["auth"]}},"/api/v1/auth/sessions/logout-all":{"delete":{"operationId":"logoutAllDevices","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Logged out from all devices successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Logged out from all devices successfully","data":{"revoked_count":5},"timestamp":"2026-01-31T10:00:00.000Z","path":"/api/v1/auth/sessions/logout-all"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/auth/sessions/logout-all"}]}}}}},"security":[{"bearer":[]}],"summary":"Logout from all devices","tags":["auth"]}},"/api/v1/auth/2fa/status":{"get":{"operationId":"status","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"2FA status + backup codes remaining","tags":["auth"]}},"/api/v1/auth/2fa/setup":{"post":{"description":"Generates a pending TOTP secret. 2FA is NOT active until `enable` verifies the first code. Fails if 2FA is already enabled (disable first).","operationId":"setup","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Setup material"}},"security":[{"bearer":[]}],"summary":"Start 2FA setup — returns secret + QR code","tags":["auth"]}},"/api/v1/auth/2fa/enable":{"post":{"description":"Verifies the first TOTP code and activates 2FA. Returns 10 single-use backup codes — shown ONCE, store them securely.","operationId":"enable","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"400":{"description":"Invalid code"}},"security":[{"bearer":[]}],"summary":"Activate 2FA — verify first code, get backup codes","tags":["auth"]}},"/api/v1/auth/2fa":{"delete":{"operationId":"disable","parameters":[{"name":"code","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Disable 2FA — requires a TOTP or backup code","tags":["auth"]}},"/api/v1/auth/2fa/backup-codes":{"post":{"description":"Invalidates the previous set. New codes shown once.","operationId":"regenerateBackupCodes","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Regenerate backup codes — requires a valid TOTP code","tags":["auth"]}},"/api/v1/auth/2fa/verify":{"post":{"operationId":"verify","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"401":{"description":"Invalid code or expired challenge"}},"summary":"Complete 2FA login — exchange the challenge token for tokens","tags":["auth"]}},"/api/v1/my-wallet":{"get":{"operationId":"getWalletInfo","parameters":[{"name":"walletId","required":false,"in":"query","description":"LNbits wallet id on my account (empty = default)","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get my wallet info + balance (auto-provisions on first access)","tags":["My Wallet"]}},"/api/v1/my-wallet/wallets":{"get":{"operationId":"listAccountWallets","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List all wallets on my LNbits account (default flagged, live balances)","tags":["My Wallet"]},"post":{"operationId":"createAccountWallet","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a new wallet on my LNbits account","tags":["My Wallet"]}},"/api/v1/my-wallet/wallets/{id}":{"patch":{"operationId":"updateAccountWallet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Rename a wallet or change its color","tags":["My Wallet"]},"delete":{"operationId":"deleteAccountWallet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a wallet from my account (not the default one)","tags":["My Wallet"]}},"/api/v1/my-wallet/wallets/{id}/default":{"post":{"operationId":"setDefaultAccountWallet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Make one of my wallets the default (receives funds for links/NIP-5/projects)","tags":["My Wallet"]}},"/api/v1/my-wallet/payments":{"get":{"operationId":"getPayments","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get my wallet payments","tags":["My Wallet"]}},"/api/v1/my-wallet/payments/export/csv":{"get":{"description":"Downloads up to 5,000 payments matching the filters as a CSV file — for accounting/reconciliation.","operationId":"exportPaymentsCsv","parameters":[{"name":"status","required":false,"in":"query","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Export wallet payments as CSV","tags":["My Wallet"]}},"/api/v1/my-wallet/payments/history":{"get":{"operationId":"getPaymentsHistory","parameters":[{"name":"group","required":false,"in":"query","schema":{"enum":["hour","day","month"],"type":"string"}},{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get my payments history for charts","tags":["My Wallet"]}},"/api/v1/my-wallet/payments/{paymentHash}/status":{"get":{"operationId":"checkPaymentStatus","parameters":[{"name":"paymentHash","required":true,"in":"path","schema":{"type":"string"}},{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Check payment status","tags":["My Wallet"]}},"/api/v1/my-wallet/invoices/{paymentHash}/cancel":{"post":{"operationId":"cancelInvoice","parameters":[{"name":"paymentHash","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Cancel a pending invoice on my wallet","tags":["My Wallet"]}},"/api/v1/my-wallet/invoices":{"post":{"operationId":"createInvoice","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create invoice (receive sats into my wallet)","tags":["My Wallet"]}},"/api/v1/my-wallet/pay":{"post":{"operationId":"payInvoice","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Pay a BOLT11 invoice (send sats from my wallet)","tags":["My Wallet"]}},"/api/v1/my-wallet/pay/lnurl":{"post":{"operationId":"payLnurl","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Pay an LNURL or lightning address","tags":["My Wallet"]}},"/api/v1/my-wallet/lnurl/scan":{"post":{"operationId":"lnurlScan","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Scan/decode an LNURL or lightning address","tags":["My Wallet"]}},"/api/v1/my-wallet/decode":{"post":{"operationId":"decodeInvoice","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Decode a BOLT11 invoice","tags":["My Wallet"]}},"/api/v1/my-wallet/pay-links":{"get":{"operationId":"getLnurlPayLinks","parameters":[{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my LNURL-pay links","tags":["My Wallet"]},"post":{"operationId":"createLnurlPayLink","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create an LNURL-pay link on my wallet","tags":["My Wallet"]}},"/api/v1/my-wallet/pay-links/{linkId}":{"delete":{"operationId":"deleteLnurlPayLink","parameters":[{"name":"linkId","required":true,"in":"path","schema":{"type":"string"}},{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete an LNURL-pay link","tags":["My Wallet"]}},"/api/v1/my-wallet/access":{"get":{"operationId":"getWalletAccess","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"How I can access my LNbits wallet account (magic link, username/password, nostr)","tags":["My Wallet"]}},"/api/v1/my-wallet/access/magic-link":{"post":{"operationId":"getMagicLink","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"One-click magic link into my LNbits wallet UI","tags":["My Wallet"]}},"/api/v1/my-wallet/access/credentials":{"post":{"operationId":"setCredentials","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Set username + password for LNbits login","tags":["My Wallet"]}},"/api/v1/my-wallet/nip5/domains":{"get":{"operationId":"getNip5Domains","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List all NIP-5 domains I can buy a lightning address on","tags":["My Wallet"]}},"/api/v1/my-wallet/nip5/domains/{domainId}":{"get":{"operationId":"getNip5DomainDetail","parameters":[{"name":"domainId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Domain detail with real pricing tiers","tags":["My Wallet"]}},"/api/v1/my-wallet/nip5/search":{"get":{"operationId":"searchNip5","parameters":[{"name":"domainId","required":true,"in":"query","schema":{"type":"string"}},{"name":"identifier","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Check identifier availability + exact price","tags":["My Wallet"]}},"/api/v1/my-wallet/nip5/addresses":{"post":{"operationId":"registerNip5","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Buy my lightning address — returns the pending address + BOLT11 invoice at the real LNbits price","tags":["My Wallet"]},"get":{"operationId":"getNip5Addresses","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my lightning addresses on the instance","tags":["My Wallet"]}},"/api/v1/my-wallet/nip5/pay":{"post":{"operationId":"payNip5Purchase","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Pay the NIP-5 purchase invoice from my wallet balance","tags":["My Wallet"]}},"/api/v1/my-wallet/nip5/payments/{paymentHash}":{"get":{"operationId":"checkNip5Purchase","parameters":[{"name":"paymentHash","required":true,"in":"path","schema":{"type":"string"}},{"name":"domainId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Check whether my NIP-5 purchase is paid (activates the address)","tags":["My Wallet"]}},"/api/v1/my-wallet/nip5/purchases/{domainId}/{addressId}":{"delete":{"operationId":"cancelNip5Purchase","parameters":[{"name":"domainId","required":true,"in":"path","schema":{"type":"string"}},{"name":"addressId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Cancel a pending (unpaid) NIP-5 purchase","tags":["My Wallet"]}},"/api/v1/my-wallet/nip5/addresses/{domainId}/{addressId}":{"post":{"operationId":"updateNip5Address","parameters":[{"name":"domainId","required":true,"in":"path","schema":{"type":"string"}},{"name":"addressId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Update one of my lightning addresses (pubkey / relays)","tags":["My Wallet"]},"delete":{"operationId":"deleteNip5Address","parameters":[{"name":"domainId","required":true,"in":"path","schema":{"type":"string"}},{"name":"addressId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete one of my lightning addresses","tags":["My Wallet"]}},"/api/v1/my-wallet/nostr":{"get":{"operationId":"getNostrProfile","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get my nostr profile","tags":["My Wallet"]}},"/api/v1/my-wallet/nostr/generate":{"post":{"operationId":"generateNostr","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Generate a brand-new nostr keypair (shows nsec once)","tags":["My Wallet"]}},"/api/v1/my-wallet/nostr/link":{"post":{"operationId":"linkNostr","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Link my existing nostr identity (npub — we never hold your key)","tags":["My Wallet"]}},"/api/v1/my-wallet/nostr/reveal":{"post":{"operationId":"revealNsec","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Reveal my generated nsec (only if ZapAPI generated it)","tags":["My Wallet"]}},"/api/v1/my-wallet/identities":{"get":{"operationId":"listIdentities","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List all my identities (primary first)","tags":["My Wallet"]}},"/api/v1/my-wallet/identities/generate":{"post":{"operationId":"generateIdentity","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Generate a new identity (nsec shown once)","tags":["My Wallet"]}},"/api/v1/my-wallet/identities/link":{"post":{"operationId":"linkIdentity","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Attach an external identity (npub — we never hold the key)","tags":["My Wallet"]}},"/api/v1/my-wallet/identities/{id}/primary":{"post":{"operationId":"setPrimaryIdentity","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Make an identity my primary (zaps, NIP-5, wallet login)","tags":["My Wallet"]}},"/api/v1/my-wallet/identities/{id}/reveal":{"post":{"operationId":"revealIdentityNsec","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Reveal a generated identity nsec","tags":["My Wallet"]}},"/api/v1/my-wallet/identities/{id}/recheck":{"post":{"operationId":"recheckIdentity","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Re-check whether a wallet exists with this key on the instance","tags":["My Wallet"]}},"/api/v1/my-wallet/identities/{id}/rename":{"post":{"operationId":"renameIdentity","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Rename an identity label","tags":["My Wallet"]}},"/api/v1/my-wallet/identities/{id}":{"delete":{"operationId":"deleteIdentity","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Remove an identity (not the primary one)","tags":["My Wallet"]}},"/api/v1/fx/currencies":{"get":{"operationId":"getCurrencies","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"List supported fiat currencies","tags":["fx"]}},"/api/v1/fx/rates":{"get":{"operationId":"getRates","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Current BTC price in all supported currencies","tags":["fx"]}},"/api/v1/fx/rate/{currency}":{"get":{"operationId":"getRate","parameters":[{"name":"currency","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Current BTC price in one currency","tags":["fx"]}},"/api/v1/fx/convert":{"get":{"operationId":"convert","parameters":[{"name":"sats","required":true,"in":"query","schema":{"type":"string"}},{"name":"currency","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Convert sats to fiat (display quote)","tags":["fx"]}},"/api/v1/nostr/profile":{"get":{"operationId":"fetchProfile","parameters":[{"name":"identityId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Fetch the newest kind 0 profile for an identity from the relay set (relay.nostrfeed.com first)","tags":["Nostr Profile"]},"post":{"operationId":"publishProfile","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Publish a kind 0 profile update (merged with relay-current). Signed with the identity key — generated identities only.","tags":["Nostr Profile"]}},"/api/v1/nostr/signer":{"get":{"operationId":"getMySigner","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get my connected remote signer (or null)","tags":["nostr"]},"delete":{"operationId":"disconnect","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Disconnect the signer — receipts fall back to the platform key","tags":["nostr"]}},"/api/v1/nostr/signer/connect":{"post":{"description":"Performs the NIP-46 handshake (connect + get_public_key) and stores the URI encrypted. Replaces any existing connection.","operationId":"connect","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Signer connected"},"400":{"description":"Invalid URI or signer unreachable"}},"security":[{"bearer":[]}],"summary":"Connect a bunker:// remote signer","tags":["nostr"]}},"/api/v1/nostr/signer/test":{"post":{"operationId":"test","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Ping the connected signer","tags":["nostr"]}},"/api/v1/nostr/profiles/{pubkey}":{"get":{"operationId":"getProfile","parameters":[{"name":"pubkey","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Resolve a kind 0 profile by hex pubkey (layered: Redis → DB → SWR relay refresh)","tags":["Nostr Profiles (public)"]}},"/api/v1/nostr/profiles":{"get":{"operationId":"getProfiles","parameters":[{"name":"pubkeys","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Batch resolve kind 0 profiles (?pubkeys=hex,hex,… — max 25)","tags":["Nostr Profiles (public)"]}},"/api/v1/nostr/zaps/mine":{"get":{"operationId":"getMyZaps","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"offset","required":false,"in":"query","schema":{"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"My zap feed — zaps I received, with lifetime totals","tags":["nostr"]}},"/api/v1/nostr/zaps/public/{address}":{"get":{"operationId":"getPublicFeed","parameters":[{"name":"address","required":true,"in":"path","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Public zap feed for a lightning address (settled zaps only)","tags":["nostr"]}},"/api/v1/scrub/rule":{"get":{"operationId":"getRule","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get my scrub rule (null when none)","tags":["Scrub"]},"put":{"description":"Every incoming payment above the reserve forwards automatically to the destination lightning address. Splits run first; scrub sees what settles.","operationId":"upsertRule","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Create or replace the scrub rule","tags":["Scrub"]},"delete":{"operationId":"deleteRule","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete the scrub rule","tags":["Scrub"]}},"/api/v1/scrub/executions":{"get":{"operationId":"listExecutions","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"offset","required":false,"in":"query","schema":{"type":"number"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Forward history (audit trail)","tags":["Scrub"]}},"/api/v1/users":{"post":{"description":"Creates a new user with email, first name, last name, and password. Password must be at least 8 characters with uppercase, lowercase, number, and special character. Requires Admin role.","operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUserDto"}}}},"responses":{"201":{"description":"User has been successfully created.","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":201,"message":"User created successfully","data":{"id":"6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe","email":"john.doe@example.com","firstName":"John","lastName":"Doe","isActive":true,"createdAt":"2026-01-27T10:23:22.983Z","updatedAt":"2026-01-27T10:23:22.983Z"},"meta":{"user_id":"6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe","created_at":"2026-01-27T10:23:22.983Z"},"timestamp":"2026-01-27T10:23:22.997Z","path":"/api/v1/users"}]}}}},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users"}]}}}},"403":{"description":"Forbidden - Insufficient permissions.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":403,"message":"Forbidden resource","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users"}]}}}},"409":{"description":"Conflict - Resource already exists.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":409,"message":"User with this email already exists","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users"}]}}}}},"security":[{"bearer":[]}],"summary":"Create a new user (Admin only)","tags":["users"]},"get":{"description":"Retrieves a paginated list of users. Use page and limit query parameters to control pagination. Requires Admin or Moderator role.","operationId":"findAll","parameters":[{"name":"page","required":false,"in":"query","description":"Page number (default: 1)","schema":{"type":"number","examples":[1]}},{"name":"limit","required":false,"in":"query","description":"Items per page (default: 10)","schema":{"type":"number","examples":[10]}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Return all users with pagination.","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Users fetched successfully","data":[{"id":"6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe","email":"john.doe@example.com","firstName":"John","lastName":"Doe","isActive":true,"createdAt":"2026-01-27T10:23:22.983Z","updatedAt":"2026-01-27T10:23:22.983Z"}],"meta":{"total":25,"count":10,"page":2,"limit":10,"total_pages":3,"has_next":true,"has_previous":true,"timestamp":"2026-01-27T10:28:36.014Z"},"timestamp":"2026-01-27T10:28:36.014Z","path":"/api/v1/users"}]}}}}},"security":[{"bearer":[]}],"summary":"Get all users with pagination (Admin/Moderator)","tags":["users"]}},"/api/v1/users/statistics":{"get":{"description":"Retrieves user statistics including total, active, inactive, and today registered counts. Requires Admin or Moderator role.","operationId":"getStatistics","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"User statistics retrieved successfully.","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Statistics fetched successfully","data":{"total":125,"active":98,"inactive":27,"pending":0,"todayRegistered":5},"meta":{"cached":false,"timestamp":"2026-01-31T10:00:00.000Z"},"timestamp":"2026-01-31T10:00:00.015Z","path":"/api/v1/users/statistics"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users/statistics"}]}}}},"403":{"description":"Forbidden - Insufficient permissions.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":403,"message":"Forbidden resource","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users/statistics"}]}}}}},"security":[{"bearer":[]}],"summary":"Get user statistics (Admin/Moderator)","tags":["users"]}},"/api/v1/users/{id}":{"get":{"description":"Retrieves a single user by their UUID. Returns cached data if available.","operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","description":"User UUID","schema":{"type":"string","examples":["6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe"]}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Return the user.","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"User fetched successfully","data":{"id":"6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe","email":"john.doe@example.com","firstName":"John","lastName":"Doe","isActive":true,"createdAt":"2026-01-27T10:23:22.983Z","updatedAt":"2026-01-27T10:23:22.983Z"},"meta":{"cached":true},"timestamp":"2026-01-27T10:28:36.014Z","path":"/api/v1/users/6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe"}]}}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"User not found","timestamp":"2026-01-27T10:28:36.014Z","path":"/api/v1/users/invalid-id"}]}}}}},"security":[{"bearer":[]}],"summary":"Get a user by ID","tags":["users"]},"patch":{"description":"Updates an existing user. All fields are optional. Cache is invalidated after update.","operationId":"update","parameters":[{"name":"id","required":true,"in":"path","description":"User UUID","schema":{"type":"string","examples":["6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe"]}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserDto"}}}},"responses":{"200":{"description":"User has been successfully updated.","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"User updated successfully","data":{"id":"6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe","email":"john.updated@example.com","firstName":"John","lastName":"Doe","isActive":true,"createdAt":"2026-01-27T10:23:22.983Z","updatedAt":"2026-01-27T10:30:00.000Z"},"meta":{"user_id":"6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe","updated_at":"2026-01-27T10:30:00.000Z"},"timestamp":"2026-01-27T10:30:00.015Z","path":"/api/v1/users/6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe"}]}}}},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","timestamp":"2026-01-27T10:30:00.015Z","path":"/api/v1/users/6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe"}]}}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"User not found","timestamp":"2026-01-27T10:30:00.015Z","path":"/api/v1/users/invalid-id"}]}}}},"409":{"description":"Conflict - Email already exists.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":409,"message":"Email already exists","timestamp":"2026-01-27T10:30:00.015Z","path":"/api/v1/users/6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe"}]}}}}},"security":[{"bearer":[]}],"summary":"Update a user","tags":["users"]},"delete":{"description":"Permanently deletes a user by their UUID. Cache is invalidated after deletion.","operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","description":"User UUID","schema":{"type":"string","examples":["6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe"]}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"User has been successfully deleted.","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"User deleted successfully","data":null,"meta":{"user_id":"6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe","deleted_at":"2026-01-27T10:35:00.000Z"},"timestamp":"2026-01-27T10:35:00.015Z","path":"/api/v1/users/6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe"}]}}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"User not found","timestamp":"2026-01-27T10:35:00.015Z","path":"/api/v1/users/invalid-id"}]}}}}},"security":[{"bearer":[]}],"summary":"Delete a user","tags":["users"]}},"/api/v1/users/search/advanced":{"get":{"description":"Search users with filters (search query, active status), sorting, and pagination.","operationId":"search","parameters":[{"name":"search","required":false,"in":"query","description":"Search query for name or email","schema":{"type":"string","examples":["john"]}},{"name":"isActive","required":false,"in":"query","description":"Filter by active status","schema":{"type":"string","examples":["true"]}},{"name":"sortBy","required":false,"in":"query","description":"Sort by field","schema":{"enum":["email","firstName","lastName","createdAt","isActive"],"type":"string"}},{"name":"sortOrder","required":false,"in":"query","description":"Sort direction","schema":{"enum":["asc","desc"],"type":"string"}},{"name":"page","required":false,"in":"query","description":"Page number","schema":{"minimum":1,"type":"number","examples":[1]}},{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"type":"number","examples":[10]}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Users search results with filters and pagination.","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Users searched successfully","data":[{"id":"6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe","email":"john.doe@example.com","firstName":"John","lastName":"Doe","isActive":true,"createdAt":"2026-01-27T10:23:22.983Z","updatedAt":"2026-01-27T10:23:22.983Z"}],"meta":{"total":15,"count":10,"page":1,"limit":10,"total_pages":2,"has_next":true,"has_previous":false,"search_query":"john","filters":{"isActive":"true"},"sort":{"field":"email","order":"asc"}},"timestamp":"2026-01-27T10:40:00.000Z","path":"/api/v1/users/search/advanced"}]}}}}},"security":[{"bearer":[]}],"summary":"Advanced search for users","tags":["users"]}},"/api/v1/users/bulk/activate":{"post":{"description":"Activates multiple users by their IDs.","operationId":"bulkActivate","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUserIdsDto"}}}},"responses":{"200":{"description":"Users have been successfully activated.","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Successfully activated 5 user(s)","data":{"affected":5},"meta":{"requested":5,"affected":5,"operation":"activate"},"timestamp":"2026-01-27T10:45:00.000Z","path":"/api/v1/users/bulk/activate"}]}}}}},"security":[{"bearer":[]}],"summary":"Bulk activate users","tags":["users"]}},"/api/v1/users/bulk/deactivate":{"post":{"description":"Deactivates multiple users by their IDs.","operationId":"bulkDeactivate","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUserIdsDto"}}}},"responses":{"200":{"description":"Users have been successfully deactivated.","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Successfully deactivated 3 user(s)","data":{"affected":3},"meta":{"requested":3,"affected":3,"operation":"deactivate"},"timestamp":"2026-01-27T10:50:00.000Z","path":"/api/v1/users/bulk/deactivate"}]}}}}},"security":[{"bearer":[]}],"summary":"Bulk deactivate users","tags":["users"]}},"/api/v1/users/bulk":{"delete":{"description":"Permanently deletes multiple users by their IDs.","operationId":"bulkDelete","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUserIdsDto"}}}},"responses":{"200":{"description":"Users have been successfully deleted.","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Successfully deleted 2 user(s)","data":{"affected":2},"meta":{"requested":2,"affected":2,"operation":"delete"},"timestamp":"2026-01-27T10:55:00.000Z","path":"/api/v1/users/bulk"}]}}}}},"security":[{"bearer":[]}],"summary":"Bulk delete users","tags":["users"]}},"/api/v1/roles":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRoleDto"}}}},"responses":{"201":{"description":"Role created successfully"},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles"}]}}}},"403":{"description":"Forbidden - Insufficient permissions.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":403,"message":"Forbidden resource","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles"}]}}}},"409":{"description":"Conflict - Resource already exists.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":409,"message":"Role already exists","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles"}]}}}}},"security":[{"bearer":[]}],"summary":"Create a new role (Admin only)","tags":["RBAC - Roles"]},"get":{"operationId":"findAll","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Roles fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles"}]}}}}},"security":[{"bearer":[]}],"summary":"Get all roles with pagination","tags":["RBAC - Roles"]}},"/api/v1/roles/statistics":{"get":{"operationId":"getStatistics","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Role statistics fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles/statistics"}]}}}}},"security":[{"bearer":[]}],"summary":"Get role statistics","tags":["RBAC - Roles"]}},"/api/v1/roles/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Role fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles/:id"}]}}}},"404":{"description":"Not Found - Role not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Role not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Get role by ID","tags":["RBAC - Roles"]},"put":{"operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRoleDto"}}}},"responses":{"200":{"description":"Role updated successfully"},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles/:id"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles/:id"}]}}}},"403":{"description":"Forbidden - Insufficient permissions.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":403,"message":"Forbidden resource","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles/:id"}]}}}},"404":{"description":"Not Found - Role not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Role not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Update role (Admin only)","tags":["RBAC - Roles"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Role deleted successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles/:id"}]}}}},"403":{"description":"Forbidden - Insufficient permissions.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":403,"message":"Forbidden resource","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles/:id"}]}}}},"404":{"description":"Not Found - Role not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Role not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/roles/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Delete role (Admin only)","tags":["RBAC - Roles"]}},"/api/v1/permissions":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePermissionDto"}}}},"responses":{"201":{"description":"Permission created successfully"},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions"}]}}}},"403":{"description":"Forbidden - Insufficient permissions.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":403,"message":"Forbidden resource","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions"}]}}}},"409":{"description":"Conflict - Resource already exists.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":409,"message":"Permission already exists","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions"}]}}}}},"security":[{"bearer":[]}],"summary":"Create a new permission (Admin only)","tags":["RBAC - Permissions"]},"get":{"operationId":"findAll","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Permissions fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions"}]}}}}},"security":[{"bearer":[]}],"summary":"Get all permissions","tags":["RBAC - Permissions"]}},"/api/v1/permissions/statistics":{"get":{"operationId":"getStatistics","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Permission statistics fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions/statistics"}]}}}}},"security":[{"bearer":[]}],"summary":"Get permission statistics","tags":["RBAC - Permissions"]}},"/api/v1/permissions/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Permission fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions/:id"}]}}}},"404":{"description":"Not Found - Permission not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Permission not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Get a permission by ID","tags":["RBAC - Permissions"]},"patch":{"operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePermissionDto"}}}},"responses":{"200":{"description":"Permission updated successfully"},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions/:id"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions/:id"}]}}}},"403":{"description":"Forbidden - Insufficient permissions.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":403,"message":"Forbidden resource","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions/:id"}]}}}},"404":{"description":"Not Found - Permission not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Permission not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions/:id"}]}}}},"409":{"description":"Conflict - Resource already exists.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":409,"message":"Permission with this name already exists","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Update a permission (Admin only)","tags":["RBAC - Permissions"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Permission deleted successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions/:id"}]}}}},"403":{"description":"Forbidden - Insufficient permissions.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":403,"message":"Forbidden resource","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions/:id"}]}}}},"404":{"description":"Not Found - Permission not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Permission not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/permissions/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Delete a permission (Admin only)","tags":["RBAC - Permissions"]}},"/api/v1/users/{userId}/roles":{"post":{"operationId":"assignRoles","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignRoleDto"}}}},"responses":{"200":{"description":"Roles assigned successfully"},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users/:userId/roles"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users/:userId/roles"}]}}}},"403":{"description":"Forbidden - Insufficient permissions.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":403,"message":"Forbidden resource","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users/:userId/roles"}]}}}},"404":{"description":"Not Found - User not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"User not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users/:userId/roles"}]}}}}},"security":[{"bearer":[]}],"summary":"Assign roles to user (Admin only)","tags":["RBAC - User Roles"]},"get":{"operationId":"getUserRoles","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"User roles fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users/:userId/roles"}]}}}},"404":{"description":"Not Found - User not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"User not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users/:userId/roles"}]}}}}},"security":[{"bearer":[]}],"summary":"Get user roles","tags":["RBAC - User Roles"]}},"/api/v1/users/{userId}/roles/{roleId}":{"delete":{"operationId":"removeRole","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"roleId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Role removed successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users/:userId/roles/:roleId"}]}}}},"403":{"description":"Forbidden - Insufficient permissions.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":403,"message":"Forbidden resource","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users/:userId/roles/:roleId"}]}}}},"404":{"description":"Not Found - User or Role not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"User or Role not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/users/:userId/roles/:roleId"}]}}}}},"security":[{"bearer":[]}],"summary":"Remove role from user (Admin only)","tags":["RBAC - User Roles"]}},"/api/v1/newsletter/subscribe":{"post":{"operationId":"subscribe","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeNewsletterDto"}}}},"responses":{"201":{"description":"Successfully subscribed to newsletter","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":201,"message":"Successfully subscribed to newsletter","data":{"id":"123e4567-e89b-12d3-a456-426614174000","email":"user@example.com","firstName":"John","lastName":"Doe","isActive":true,"subscribedAt":"2026-02-01T10:00:00.000Z"},"meta":{"subscriber_id":"123e4567-e89b-12d3-a456-426614174000","subscribed_at":"2026-02-01T10:00:00.000Z"}}]}}}},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/subscribe"}]}}}},"409":{"description":"Conflict - Resource already exists.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":409,"message":"Email already subscribed to newsletter","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/subscribe"}]}}}}},"summary":"Subscribe to newsletter (public)","tags":["newsletter"]}},"/api/v1/newsletter/unsubscribe/{email}":{"post":{"operationId":"unsubscribe","parameters":[{"name":"email","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Successfully unsubscribed from newsletter","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Successfully unsubscribed from newsletter","meta":{"unsubscribed_at":"2026-02-01T10:00:00.000Z"}}]}}}},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/unsubscribe/:email"}]}}}},"404":{"description":"Not Found - Email not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Email not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/unsubscribe/:email"}]}}}}},"summary":"Unsubscribe from newsletter (public)","tags":["newsletter"]}},"/api/v1/newsletter":{"get":{"operationId":"findAll","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Newsletter subscribers fetched successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Newsletter subscribers fetched successfully","data":[{"id":"123e4567-e89b-12d3-a456-426614174000","email":"user@example.com","firstName":"John","lastName":"Doe","isActive":true,"subscribedAt":"2026-02-01T10:00:00.000Z"}],"meta":{"total":100,"count":50,"page":1,"limit":50,"total_pages":2,"has_next":true,"has_previous":false}}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter"}]}}}}},"security":[{"bearer":[]}],"summary":"Get all newsletter subscribers (admin)","tags":["newsletter"]}},"/api/v1/newsletter/statistics":{"get":{"operationId":"getStatistics","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Newsletter statistics fetched successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Newsletter statistics fetched successfully","data":{"total":1000,"active":850,"inactive":150,"todaySubscribed":25}}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/statistics"}]}}}}},"security":[{"bearer":[]}],"summary":"Get newsletter statistics (admin)","tags":["newsletter"]}},"/api/v1/newsletter/send":{"post":{"operationId":"sendNewsletter","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendNewsletterDto"}}}},"responses":{"200":{"description":"Newsletter sent successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Newsletter sent successfully","meta":{"total_subscribers":850,"sent":845,"failed":5}}]}}}},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/send"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/send"}]}}}}},"security":[{"bearer":[]}],"summary":"Send newsletter to all active subscribers (admin)","tags":["newsletter"]}},"/api/v1/newsletter/subscribers":{"post":{"operationId":"addSubscriber","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeNewsletterDto"}}}},"responses":{"201":{"description":"Subscriber added successfully"},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/subscribers"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/subscribers"}]}}}},"409":{"description":"Conflict - Resource already exists.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":409,"message":"Email already subscribed to newsletter","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/subscribers"}]}}}}},"security":[{"bearer":[]}],"summary":"Add a subscriber manually (admin)","tags":["newsletter"]}},"/api/v1/newsletter/{id}":{"patch":{"operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSubscriberDto"}}}},"responses":{"200":{"description":"Subscriber updated successfully"},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/:id"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/:id"}]}}}},"404":{"description":"Not Found - Subscriber not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Subscriber not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/:id"}]}}}},"409":{"description":"Conflict - Resource already exists.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":409,"message":"Another subscriber already uses this email","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Update a newsletter subscriber (admin)","tags":["newsletter"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Subscriber deleted successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Subscriber deleted successfully","meta":{"deleted_id":"123e4567-e89b-12d3-a456-426614174000"}}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/:id"}]}}}},"404":{"description":"Not Found - Subscriber not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Subscriber not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/newsletter/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Delete newsletter subscriber (admin)","tags":["newsletter"]}},"/api/v1/analytics/track":{"post":{"operationId":"trackVisitor","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackVisitorDto"}}}},"responses":{"201":{"description":"Visitor tracked successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":201,"message":"Visitor tracked successfully","data":{"tracked":true,"visitorId":"uuid"}}]}}}}},"summary":"Track website visitor","tags":["analytics"]}},"/api/v1/analytics/dashboard":{"get":{"operationId":"getAnalytics","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Analytics data fetched successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Analytics fetched successfully","data":{"overview":{"totalVisitors":1250,"uniqueVisitors":850,"todayVisitors":45,"weekVisitors":320,"monthVisitors":1150,"returningVisitors":400,"newVisitors":850},"topCountries":[{"country":"United States","countryCode":"US","count":450},{"country":"India","countryCode":"IN","count":320}],"topCities":[{"city":"New York","country":"United States","count":120}],"topPages":[{"page":"/","count":500},{"page":"/about","count":250}],"browserStats":[{"browser":"Chrome","count":800},{"browser":"Safari","count":300}],"osStats":[{"os":"Windows","count":600},{"os":"Mac OS","count":400}],"deviceStats":[{"device":"desktop","count":800},{"device":"mobile","count":400}]}}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/analytics/dashboard"}]}}}}},"security":[{"bearer":[]}],"summary":"Get analytics dashboard data","tags":["analytics"]}},"/api/v1/analytics/trend":{"get":{"operationId":"getVisitorTrend","parameters":[{"name":"days","required":false,"in":"query","schema":{"type":"number","examples":[7]}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Visitor trend fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/analytics/trend"}]}}}}},"security":[{"bearer":[]}],"summary":"Get daily visitor trend for the last N days","tags":["analytics"]}},"/api/v1/analytics/recent":{"get":{"operationId":"getRecentVisitors","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"number","examples":[50]}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Recent visitors fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/analytics/recent"}]}}}}},"security":[{"bearer":[]}],"summary":"Get recent visitors","tags":["analytics"]}},"/api/v1/contact":{"post":{"description":"Public endpoint for contact form submissions. Sends email to admin.","operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateContactDto"}}}},"responses":{"201":{"description":"Contact form submitted successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":201,"message":"Thank you for contacting us! We will get back to you soon.","data":{"id":"uuid","name":"John Doe","email":"john@example.com","subject":"General Inquiry","message":"I would like to know more...","status":"new","createdAt":"2026-02-01T10:00:00.000Z"},"meta":{"contact_id":"uuid","created_at":"2026-02-01T10:00:00.000Z"}}]}}}},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/contact"}]}}}}},"summary":"Submit contact form","tags":["contact"]},"get":{"description":"Admin endpoint to retrieve contact submissions with pagination and filtering","operationId":"findAll","parameters":[{"name":"page","required":false,"in":"query","description":"Page number","schema":{"type":"number","examples":[1]}},{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"type":"number","examples":[20]}},{"name":"status","required":false,"in":"query","description":"Filter by status","schema":{"type":"string","examples":["new"]}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Contact submissions fetched successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Contact submissions fetched successfully","data":[{"id":"uuid","name":"John Doe","email":"john@example.com","phone":"+1234567890","subject":"General Inquiry","message":"I would like to know more...","status":"new","ipAddress":"192.168.1.1","createdAt":"2026-02-01T10:00:00.000Z"}],"meta":{"total":50,"count":20,"page":1,"limit":20,"total_pages":3,"has_next":true,"has_previous":false}}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/contact"}]}}}}},"security":[{"bearer":[]}],"summary":"Get all contact submissions","tags":["contact"]}},"/api/v1/contact/statistics":{"get":{"description":"Admin endpoint to get contact submission statistics","operationId":"getStatistics","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Statistics fetched successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"Contact statistics fetched successfully","data":{"total":150,"new":25,"read":50,"replied":60,"today":5}}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/contact/statistics"}]}}}}},"security":[{"bearer":[]}],"summary":"Get contact statistics","tags":["contact"]}},"/api/v1/contact/{id}":{"get":{"description":"Admin endpoint to get single contact submission. Auto-marks as read.","operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Contact submission fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/contact/:id"}]}}}},"404":{"description":"Not Found - Contact not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Contact not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/contact/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Get contact submission by ID","tags":["contact"]},"patch":{"description":"Admin endpoint to update contact submission status","operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateContactDto"}}}},"responses":{"200":{"description":"Contact status updated successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/contact/:id"}]}}}},"404":{"description":"Not Found - Contact not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Contact not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/contact/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Update contact status","tags":["contact"]},"delete":{"description":"Admin endpoint to delete contact submission","operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Contact submission deleted successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/contact/:id"}]}}}},"404":{"description":"Not Found - Contact not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Contact not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/contact/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Delete contact submission","tags":["contact"]}},"/api/v1/blog":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBlogPostDto"}}}},"responses":{"201":{"description":"Blog post created successfully","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":201,"message":"Blog post created successfully","data":{"id":"uuid","title":"How to Build a Modern Web App","slug":"how-to-build-a-modern-web-app","content":"

Introduction

","status":"draft","readTime":5,"createdAt":"2026-02-02T10:00:00.000Z"},"meta":{"blog_post_id":"uuid","slug":"how-to-build-a-modern-web-app","created_at":"2026-02-02T10:00:00.000Z"}}]}}}},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog"}]}}}}},"security":[{"bearer":[]}],"summary":"Create a new blog post","tags":["blog"]}},"/api/v1/blog/admin":{"get":{"operationId":"findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"type":"string"}},{"name":"category","required":false,"in":"query","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Blog posts fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/admin"}]}}}}},"security":[{"bearer":[]}],"summary":"Get all blog posts (admin)","tags":["blog"]}},"/api/v1/blog/published":{"get":{"operationId":"findPublished","parameters":[{"name":"page","required":false,"in":"query","schema":{"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"category","required":false,"in":"query","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Published blog posts fetched successfully"}},"summary":"Get published blog posts (public)","tags":["blog"]}},"/api/v1/blog/slug/{slug}":{"get":{"operationId":"findBySlug","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Blog post fetched successfully"},"404":{"description":"Not Found - Blog post not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Blog post not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/slug/:slug"}]}}}}},"summary":"Get blog post by slug (public)","tags":["blog"]}},"/api/v1/blog/statistics":{"get":{"operationId":"getStatistics","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Blog statistics fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/statistics"}]}}}}},"security":[{"bearer":[]}],"summary":"Get blog statistics","tags":["blog"]}},"/api/v1/blog/categories":{"get":{"operationId":"getCategories","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Categories fetched successfully"}},"summary":"Get all blog categories with post counts","tags":["blog"]},"post":{"operationId":"createCategory","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBlogCategoryDto"}}}},"responses":{"201":{"description":"Category created successfully"},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/categories"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/categories"}]}}}},"409":{"description":"Conflict - Resource already exists.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":409,"message":"Category already exists","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/categories"}]}}}}},"security":[{"bearer":[]}],"summary":"Create new blog category with SEO fields","tags":["blog"]}},"/api/v1/blog/categories/{id}":{"get":{"operationId":"getCategoryById","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Category fetched successfully"},"404":{"description":"Not Found - Category not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Category not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/categories/:id"}]}}}}},"summary":"Get blog category by ID","tags":["blog"]},"patch":{"operationId":"updateCategory","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateBlogCategoryDto"}}}},"responses":{"200":{"description":"Category updated successfully"},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/categories/:id"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/categories/:id"}]}}}},"404":{"description":"Not Found - Category not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Category not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/categories/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Update blog category","tags":["blog"]},"delete":{"operationId":"deleteCategory","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Category deleted successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/categories/:id"}]}}}},"404":{"description":"Not Found - Category not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Category not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/categories/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Delete blog category","tags":["blog"]}},"/api/v1/blog/tags":{"get":{"operationId":"getTags","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Tags fetched successfully"}},"summary":"Get all blog tags","tags":["blog"]}},"/api/v1/blog/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Blog post fetched successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/:id"}]}}}},"404":{"description":"Not Found - Blog post not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Blog post not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Get blog post by ID","tags":["blog"]},"patch":{"operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateBlogPostDto"}}}},"responses":{"200":{"description":"Blog post updated successfully"},"400":{"description":"Bad Request - Validation failed.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":400,"message":"Validation failed","errors":["Field is required","Invalid format"],"timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/:id"}]}}}},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/:id"}]}}}},"404":{"description":"Not Found - Blog post not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Blog post not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Update blog post","tags":["blog"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Blog post deleted successfully"},"401":{"description":"Unauthorized - Invalid or missing JWT token.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":401,"message":"Unauthorized","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/:id"}]}}}},"404":{"description":"Not Found - Blog post not found.","content":{"application/json":{"schema":{"examples":[{"status":"error","statusCode":404,"message":"Blog post not found","timestamp":"2026-01-31T19:20:00.000Z","path":"/api/v1/blog/:id"}]}}}}},"security":[{"bearer":[]}],"summary":"Delete blog post","tags":["blog"]}},"/api/v1/projects":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProjectDto"}}}},"responses":{"201":{"description":"Project created successfully"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Create a new project","tags":["Projects"]},"get":{"operationId":"findAll","parameters":[{"name":"environment","required":false,"in":"query","schema":{"enum":["development","production"],"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Projects retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get all projects","tags":["Projects"]}},"/api/v1/projects/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Project retrieved successfully"},"403":{"description":"Access denied"},"404":{"description":"Project not found"}},"security":[{"bearer":[]}],"summary":"Get a single project","tags":["Projects"]},"patch":{"operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProjectDto"}}}},"responses":{"200":{"description":"Project updated successfully"},"404":{"description":"Project not found"}},"security":[{"bearer":[]}],"summary":"Update a project","tags":["Projects"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Project deleted successfully"},"404":{"description":"Project not found"}},"security":[{"bearer":[]}],"summary":"Delete a project","tags":["Projects"]}},"/api/v1/projects/{id}/stats":{"get":{"operationId":"getStats","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Statistics retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get project statistics","tags":["Projects"]}},"/api/v1/projects/{id}/wallet":{"get":{"operationId":"getProjectWallet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get the project settlement wallet (default / dedicated / account / nwc / provider)","tags":["Projects"]},"patch":{"operationId":"setProjectWallet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Link the settlement wallet: 'default' | 'account:' | 'nwc:' | 'provider:' (legacy)","tags":["Projects"]}},"/api/v1/projects/{id}/wallet/dedicated":{"post":{"operationId":"createDedicatedWallet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a dedicated LNbits wallet for this project and link it as the settlement wallet","tags":["Projects"]}},"/api/v1/projects/members/pending":{"get":{"operationId":"listPending","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"My pending invitations (accept/decline here)","tags":["Projects"]}},"/api/v1/projects/shared":{"get":{"operationId":"listShared","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Projects shared with me (I am a member)","tags":["Projects"]}},"/api/v1/projects/{projectId}/members":{"get":{"operationId":"listMembers","parameters":[{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List project members (viewer+)","tags":["Projects"]},"post":{"description":"The invited user must have a ZapAPI account. Role: editor (read+write) or viewer (read-only).","operationId":"invite","parameters":[{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Invite a member by email (owner only)","tags":["Projects"]}},"/api/v1/projects/members/{memberId}/accept":{"post":{"operationId":"accept","parameters":[{"name":"memberId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Accept an invitation","tags":["Projects"]}},"/api/v1/projects/members/{memberId}/role":{"patch":{"operationId":"updateRole","parameters":[{"name":"memberId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Change a member role (owner only)","tags":["Projects"]}},"/api/v1/projects/members/{memberId}":{"delete":{"operationId":"revoke","parameters":[{"name":"memberId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Revoke membership or decline an invitation","tags":["Projects"]}},"/api/v1/providers":{"post":{"description":"`type=lnbits` (BYO external wallet via URL + keys) has been removed — external wallets connect exclusively via NWC (`POST /nwc-connections`).","operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProviderDto"}}}},"responses":{"201":{"description":"Provider created successfully"},"400":{"description":"type=lnbits is no longer supported — use NWC connections"}},"security":[{"bearer":[]}],"summary":"Create a new provider connection","tags":["Providers"]},"get":{"operationId":"findAll","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Providers retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get all providers","tags":["Providers"]}},"/api/v1/providers/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Provider retrieved successfully"},"404":{"description":"Provider not found"}},"security":[{"bearer":[]}],"summary":"Get a single provider","tags":["Providers"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Provider deleted successfully"},"404":{"description":"Provider not found"}},"security":[{"bearer":[]}],"summary":"Delete a provider","tags":["Providers"]}},"/api/v1/providers/{id}/test":{"post":{"operationId":"testConnection","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Connection test completed"}},"security":[{"bearer":[]}],"summary":"Test provider connection","tags":["Providers"]}},"/api/v1/providers/{id}/disconnect":{"post":{"operationId":"disconnect","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Provider disconnected successfully"}},"security":[{"bearer":[]}],"summary":"Disconnect provider","tags":["Providers"]}},"/api/v1/api-keys":{"post":{"description":"Creates a new API key. The full key is only shown ONCE - save it securely!","operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyDto"}}}},"responses":{"201":{"description":"API key created successfully. Full key is returned only once."}},"security":[{"bearer":[]}],"summary":"Create a new API key","tags":["API Keys"]},"get":{"operationId":"findAll","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"API keys retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get all API keys","tags":["API Keys"]}},"/api/v1/api-keys/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"API key retrieved successfully"},"404":{"description":"API key not found"}},"security":[{"bearer":[]}],"summary":"Get a single API key","tags":["API Keys"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"API key deleted successfully"},"404":{"description":"API key not found"}},"security":[{"bearer":[]}],"summary":"Delete an API key","tags":["API Keys"]}},"/api/v1/api-keys/{id}/revoke":{"post":{"operationId":"revoke","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"API key revoked successfully"},"404":{"description":"API key not found"}},"security":[{"bearer":[]}],"summary":"Revoke an API key","tags":["API Keys"]}},"/api/v1/invoices/public/{id}":{"get":{"description":"Safe public fields for rendering the hosted checkout: amount, description, bolt11, status, expiry, merchant name, success/cancel URLs.","operationId":"getPublicView","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Public invoice view (hosted checkout page)","tags":["Invoices"]}},"/api/v1/invoices":{"post":{"description":"Creates a BOLT11 invoice settling to the project's settlement wallet (linked on the dashboard — default wallet when none is linked). projectId is optional for project-scoped API keys. Authenticate with a zap_live_/zap_test_ API key (invoices:write scope) or a dashboard JWT. Test keys create testMode invoices (webhook livemode: false). Supports fiat denominations via the currency field.","operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInvoiceDto"}}}},"responses":{"201":{"description":"Invoice created successfully"},"400":{"description":"Invalid request"}},"security":[{"bearer":[]}],"summary":"Create a new Lightning invoice","tags":["Invoices"]},"get":{"operationId":"findAll","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["pending","partial","paid","expired","cancelled"],"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"offset","required":false,"in":"query","schema":{"type":"number"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Invoices retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get all invoices","tags":["Invoices"]}},"/api/v1/invoices/export/csv":{"get":{"description":"Downloads ALL invoices matching the filters (no pagination limit) as a CSV file — for accounting/reconciliation.","operationId":"exportCsv","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["pending","partial","paid","expired","cancelled"],"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"CSV file download","content":{"text/csv":{}}}},"security":[{"bearer":[]}],"summary":"Export invoices as CSV","tags":["Invoices"]}},"/api/v1/invoices/stats":{"get":{"operationId":"getStats","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Statistics retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get invoice statistics","tags":["Invoices"]}},"/api/v1/invoices/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Invoice retrieved successfully"},"404":{"description":"Invoice not found"}},"security":[{"bearer":[]}],"summary":"Get a single invoice","tags":["Invoices"]}},"/api/v1/invoices/{id}/status":{"get":{"operationId":"checkStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Status retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Check invoice status (polls provider for updates)","tags":["Invoices"]}},"/api/v1/invoices/{id}/cancel":{"post":{"operationId":"cancel","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Invoice cancelled successfully"},"400":{"description":"Invoice cannot be cancelled"}},"security":[{"bearer":[]}],"summary":"Cancel an invoice","tags":["Invoices"]}},"/api/v1/invoices/{id}/qrcode":{"get":{"operationId":"getQRCode","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"QR code generated successfully"},"404":{"description":"Invoice not found"}},"security":[{"bearer":[]}],"summary":"Get QR code for invoice","tags":["Invoices"]}},"/api/v1/discounts":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDiscountDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a discount (coupon or automatic offer)","tags":["discounts"]},"get":{"operationId":"list","parameters":[{"name":"projectId","required":true,"in":"query","schema":{"type":"string"}},{"name":"mode","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List discounts for a project","tags":["discounts"]}},"/api/v1/discounts/{id}":{"patch":{"operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDiscountDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update a discount","tags":["discounts"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a discount","tags":["discounts"]}},"/api/v1/discounts/validate":{"post":{"operationId":"validate","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateCouponDto"}}}},"responses":{"201":{"description":""}},"summary":"Validate a coupon code for a project + amount (public checkout)","tags":["discounts"]}},"/api/v1/discounts/offer":{"post":{"operationId":"resolveOffer","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveOfferDto"}}}},"responses":{"201":{"description":""}},"summary":"Resolve the auto-applied offer for a project + amount (public)","tags":["discounts"]}},"/api/v1/refunds/invoice/{invoiceId}":{"post":{"description":"Lightning has no chargebacks — refunds are merchant-initiated. type=credit records a note (settle off-band); type=payment sends sats back to the customer bolt11/lightning address. Partial refunds supported while total refunded ≤ invoice amount.","operationId":"create","parameters":[{"name":"invoiceId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRefundDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a refund for a paid invoice","tags":["Refunds"]},"get":{"operationId":"listForInvoice","parameters":[{"name":"invoiceId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List refunds for an invoice","tags":["Refunds"]}},"/api/v1/refunds":{"get":{"operationId":"listAll","parameters":[{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"offset","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List all refunds (merchant)","tags":["Refunds"]}},"/api/v1/payments":{"get":{"operationId":"findAll","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["pending","completed","failed"],"type":"string"}},{"name":"type","required":false,"in":"query","schema":{"enum":["incoming","outgoing"],"type":"string"}},{"name":"label","required":false,"in":"query","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"offset","required":false,"in":"query","schema":{"type":"number"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Payments retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get all payments","tags":["Payments"]}},"/api/v1/payments/stats/daily":{"get":{"description":"Income/spend/fee/count per UTC day for the last N days (default 30, max 365). LNbits-style aggregation for dashboard charts.","operationId":"getDailyStats","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"days","required":false,"in":"query","schema":{"type":"number"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Daily payment statistics","tags":["Payments"]}},"/api/v1/payments/stats/count":{"get":{"description":"Group payments by status, project, type or label (LNbits stats/count equivalent).","operationId":"getCountStats","parameters":[{"name":"by","required":true,"in":"query","schema":{"enum":["status","project","type","label"],"type":"string"}},{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Payment totals grouped by a dimension","tags":["Payments"]}},"/api/v1/payments/labels":{"get":{"operationId":"listLabels","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"All payment labels in use (for autocomplete)","tags":["Payments"]}},"/api/v1/payments/export/csv":{"get":{"description":"Downloads ALL payments matching the filters (no pagination limit) as a CSV file — for accounting/reconciliation.","operationId":"exportCsv","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["pending","completed","failed"],"type":"string"}},{"name":"type","required":false,"in":"query","schema":{"enum":["incoming","outgoing"],"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"CSV file download","content":{"text/csv":{}}}},"security":[{"bearer":[]}],"summary":"Export payments as CSV","tags":["Payments"]}},"/api/v1/payments/stats":{"get":{"operationId":"getStats","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Statistics retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get payment statistics","tags":["Payments"]}},"/api/v1/payments/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Payment retrieved successfully"},"404":{"description":"Payment not found"}},"security":[{"bearer":[]}],"summary":"Get a single payment","tags":["Payments"]}},"/api/v1/payments/{paymentHash}/labels":{"put":{"description":"Replace the payment labels (max 10, 50 chars each, lowercased). LNbits-compatible endpoint for accounting/reconciliation workflows.","operationId":"updateLabels","parameters":[{"name":"paymentHash","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Labels updated"},"404":{"description":"Payment not found"}},"security":[{"bearer":[]}],"summary":"Update payment labels","tags":["Payments"]}},"/api/v1/webhooks":{"post":{"description":"Creates a new webhook. The secret is only shown ONCE - save it securely! Requires webhooks:write scope when using an API key.","operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookDto"}}}},"responses":{"201":{"description":"Webhook created successfully. Secret is returned only once."}},"security":[{"bearer":[]}],"summary":"Create a new webhook endpoint","tags":["Webhooks"]},"get":{"operationId":"findAll","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Webhooks retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get all webhooks","tags":["Webhooks"]}},"/api/v1/webhooks/deliveries":{"get":{"operationId":"findDeliveries","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"page","required":false,"in":"query","schema":{"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"enum":["success","failed","pending"],"type":"string"}},{"name":"event","required":false,"in":"query","schema":{"type":"string"}},{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"webhookId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List webhook deliveries (retry dashboard)","tags":["Webhooks"]}},"/api/v1/webhooks/deliveries/stats":{"get":{"operationId":"deliveryStats","parameters":[{"name":"webhookId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delivery status counts for dashboard stat cards","tags":["Webhooks"]}},"/api/v1/webhooks/deliveries/export/csv":{"get":{"description":"Downloads up to 10,000 delivery attempts matching the filters as a CSV file.","operationId":"exportDeliveriesCsv","parameters":[{"name":"status","required":false,"in":"query","schema":{"enum":["success","failed","pending"],"type":"string"}},{"name":"event","required":false,"in":"query","schema":{"type":"string"}},{"name":"webhookId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"CSV file download","content":{"text/csv":{}}}},"security":[{"bearer":[]}],"summary":"Export webhook deliveries as CSV","tags":["Webhooks"]}},"/api/v1/webhooks/deliveries/{id}":{"get":{"operationId":"findDelivery","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"404":{"description":"Delivery not found"}},"security":[{"bearer":[]}],"summary":"Get a single delivery (full payload + error)","tags":["Webhooks"]}},"/api/v1/webhooks/deliveries/{id}/retry":{"post":{"description":"Re-delivers the exact stored payload to the original endpoint with a fresh attempt counter.","operationId":"retryDelivery","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"400":{"description":"Delivery is still in progress"}},"security":[{"bearer":[]}],"summary":"Manually retry a delivery","tags":["Webhooks"]}},"/api/v1/webhooks/events/{eventId}/replay":{"post":{"description":"Re-delivers the stored event byte-identically (same evt_ id) to every endpoint that originally received it. Consumers can dedup on the event id.","operationId":"replayEvent","parameters":[{"name":"eventId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"404":{"description":"No deliveries found for this event"}},"security":[{"bearer":[]}],"summary":"Replay an event to all subscribed endpoints","tags":["Webhooks"]}},"/api/v1/webhooks/{id}/test":{"post":{"operationId":"testWebhook","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Test webhook sent"}},"security":[{"bearer":[]}],"summary":"Test webhook delivery","tags":["Webhooks"]}},"/api/v1/webhooks/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Webhook retrieved successfully"},"404":{"description":"Webhook not found"}},"security":[{"bearer":[]}],"summary":"Get a single webhook","tags":["Webhooks"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Webhook deleted successfully"},"404":{"description":"Webhook not found"}},"security":[{"bearer":[]}],"summary":"Delete a webhook","tags":["Webhooks"]}},"/api/v1/webhooks/{id}/secret":{"get":{"description":"Returns the webhook signing secret (for verifying deliveries with the SDK). Owner-only; the secret is select:false everywhere else.","operationId":"revealSecret","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"The signing secret"}},"security":[{"bearer":[]}],"summary":"Reveal the webhook signing secret","tags":["Webhooks"]}},"/api/v1/webhooks/{id}/roll-secret":{"post":{"description":"Generates a NEW secret and invalidates the old one immediately. Update your server with the new secret — deliveries after rotation are signed with it.","operationId":"rollSecret","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Roll (rotate) the webhook signing secret","tags":["Webhooks"]}},"/api/v1/webhooks/{id}/status":{"patch":{"operationId":"updateStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Webhook status updated successfully"}},"security":[{"bearer":[]}],"summary":"Update webhook status","tags":["Webhooks"]}},"/api/v1/creator-plans":{"get":{"operationId":"listPlans","parameters":[{"name":"includeInactive","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my subscription plans","tags":["creator-plans"]},"post":{"operationId":"createPlan","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePlanDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a plan","tags":["creator-plans"]}},"/api/v1/creator-plans/{id}":{"patch":{"operationId":"updatePlan","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePlanDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update a plan","tags":["creator-plans"]},"delete":{"operationId":"deletePlan","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete (or deactivate) a plan","tags":["creator-plans"]}},"/api/v1/creator-plans/subscriptions":{"get":{"operationId":"listSubscribers","parameters":[{"name":"planId","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my subscribers","tags":["creator-plans"]}},"/api/v1/creator-plans/revenue":{"get":{"operationId":"getRevenue","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"MRR/ARR stats","tags":["creator-plans"]}},"/api/v1/creator-plans/my-subscriptions":{"get":{"operationId":"listMySubscriptions","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Subscriptions I made to creators (subscriber dashboard)","tags":["creator-plans"]}},"/api/v1/creator-plans/subscriptions/{id}/cancel":{"post":{"operationId":"cancelSubscriber","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Cancel a subscriber (creator action)","tags":["creator-plans"]}},"/api/v1/subscribe/plans/{id}":{"get":{"operationId":"getPublicPlan","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Public plan detail (checkout page)","tags":["subscribe"]}},"/api/v1/subscribe/plans/{id}/subscribe":{"post":{"operationId":"subscribe","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeDto"}}}},"responses":{"201":{"description":""}},"summary":"Subscribe to a plan (public checkout)","tags":["subscribe"]}},"/api/v1/subscribe/portal/{token}":{"get":{"operationId":"getPortal","parameters":[{"name":"token","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Subscriber portal (magic link)","tags":["subscribe"]}},"/api/v1/subscribe/portal/{token}/cancel":{"post":{"operationId":"cancelPortal","parameters":[{"name":"token","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"summary":"Cancel via magic link","tags":["subscribe"]}},"/api/v1/subscribe/portal/{token}/pause":{"post":{"operationId":"pausePortal","parameters":[{"name":"token","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"summary":"Pause renewals via magic link","tags":["subscribe"]}},"/api/v1/subscribe/portal/{token}/resume":{"post":{"operationId":"resumePortal","parameters":[{"name":"token","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"summary":"Resume via magic link","tags":["subscribe"]}},"/api/v1/subscribe/portal/{token}/nwc":{"post":{"operationId":"enableNwc","parameters":[{"name":"token","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"summary":"Enable NWC auto-pay (subscriber wallet connection)","tags":["subscribe"]}},"/api/v1/subscribe/portal/{token}/nwc/disable":{"post":{"operationId":"disableNwc","parameters":[{"name":"token","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"summary":"Disable NWC auto-pay","tags":["subscribe"]}},"/api/v1/plans":{"post":{"description":"Creates a recurring-billing plan on a project. projectId is optional for project-scoped API keys. Checkout URL: /subscribe/:planId.","operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePlanDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a subscription plan","tags":["plans"]},"get":{"description":"projectId → that project’s plans (optional for project-scoped keys). Omit → your creator plans.","operationId":"list","parameters":[{"name":"projectId","required":true,"in":"query","schema":{"type":"string"}},{"name":"includeInactive","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List subscription plans","tags":["plans"]}},"/api/v1/plans/{id}":{"get":{"operationId":"get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get one plan (owner)","tags":["plans"]},"patch":{"operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePlanDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update a plan","tags":["plans"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a plan (deactivates instead when it has subscribers)","tags":["plans"]}},"/api/v1/plans/{id}/subscriptions":{"get":{"operationId":"subscriptions","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"offset","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Subscribers of one plan (paginated)","tags":["plans"]}},"/api/v1/subscriptions":{"get":{"description":"projectId is required for account-level keys; project-scoped keys fill it in automatically.","operationId":"list","parameters":[{"name":"projectId","required":true,"in":"query","schema":{"type":"string"}},{"name":"planId","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"offset","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List subscribers of a project","tags":["subscriptions"]}},"/api/v1/subscriptions/revenue":{"get":{"operationId":"revenue","parameters":[{"name":"projectId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Project MRR/ARR in sats","tags":["subscriptions"]}},"/api/v1/subscriptions/{id}/cancel":{"post":{"operationId":"cancel","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Cancel a subscription (owner action)","tags":["subscriptions"]}},"/api/v1/customers":{"get":{"operationId":"list","parameters":[{"name":"projectId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List customers (search, tag, segment, sort, project filter)","tags":["customers"]}},"/api/v1/customers/stats":{"get":{"operationId":"getStats","parameters":[{"name":"projectId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"CRM segment stats","tags":["customers"]}},"/api/v1/customers/leaderboard":{"get":{"operationId":"getLeaderboard","parameters":[{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Top supporters leaderboard","tags":["customers"]}},"/api/v1/customers/{id}":{"get":{"operationId":"detail","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Customer detail (payments, subscriptions, segment)","tags":["customers"]},"patch":{"operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCustomerDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update customer (tags, notes, display name)","tags":["customers"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"mode","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"GDPR anonymize (or delete if no payments)","tags":["customers"]}},"/api/v1/customers/{id}/export":{"get":{"operationId":"export","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"GDPR data export (JSON)","tags":["customers"]}},"/api/v1/notifications":{"get":{"operationId":"list","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"unread","required":false,"in":"query","description":"Only unread notifications","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my notifications (paginated)","tags":["notifications"]}},"/api/v1/notifications/unread-count":{"get":{"operationId":"unreadCount","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Unread count for the bell badge","tags":["notifications"]}},"/api/v1/notifications/read-all":{"patch":{"operationId":"markAllRead","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Mark all notifications as read","tags":["notifications"]}},"/api/v1/notifications/{id}/read":{"patch":{"operationId":"markRead","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Mark one notification as read","tags":["notifications"]}},"/api/v1/notifications/{id}":{"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a notification","tags":["notifications"]}},"/api/v1/notifications/preferences":{"get":{"operationId":"getPreferences","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get my notification preferences (auto-created with defaults)","tags":["notifications"]},"patch":{"operationId":"updatePreferences","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePreferencesDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update my notification preferences","tags":["notifications"]}},"/api/v1/nwc-connections":{"get":{"operationId":"findAll","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my connected NWC wallets","tags":["NWC Connections"]},"post":{"description":"Validates the URI with a live get_info round-trip before saving. The connection string is stored AES-encrypted and can be revoked any time from the wallet app.","operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateNwcConnectionDto"}}}},"responses":{"201":{"description":"Wallet connected"},"400":{"description":"Invalid URI or wallet unreachable"}},"security":[{"bearer":[]}],"summary":"Connect a wallet via a Nostr Wallet Connect URI","tags":["NWC Connections"]}},"/api/v1/nwc-connections/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Connection detail","tags":["NWC Connections"]},"patch":{"operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateNwcConnectionDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Rename a connection","tags":["NWC Connections"]},"delete":{"description":"Removes the stored connection string. Also revoke the connection in your wallet app to fully close the session.","operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Disconnect a wallet","tags":["NWC Connections"]}},"/api/v1/nwc-connections/{id}/refresh":{"post":{"operationId":"refresh","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Re-test the connection and refresh cached alias/balance","tags":["NWC Connections"]}},"/api/v1/nwc-connections/{id}/pay":{"post":{"description":"Executes pay_invoice over Nostr Wallet Connect. The wallet service must be online. Returns the payment preimage as proof.","operationId":"payInvoice","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":"Payment sent"},"400":{"description":"Wallet unreachable or payment failed"}},"security":[{"bearer":[]}],"summary":"Pay a BOLT11 invoice from this wallet","tags":["NWC Connections"]}},"/api/v1/bio/public/{slug}":{"get":{"operationId":"getPublicPage","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Page payload"},"404":{"description":"No such page"}},"summary":"Public bio page payload","tags":["bio-links"]}},"/api/v1/bio/click/{blockId}":{"get":{"operationId":"trackClick","parameters":[{"name":"blockId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Track block click + redirect","tags":["bio-links"]}},"/api/v1/bio/page":{"get":{"operationId":"getMyPage","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get my bio page","tags":["bio-links"]},"put":{"operationId":"upsertMyPage","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertBioPageDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Create or update my bio page","tags":["bio-links"]},"delete":{"operationId":"deleteMyPage","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete my bio page","tags":["bio-links"]}},"/api/v1/bio/blocks":{"get":{"operationId":"listBlocks","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my page blocks","tags":["bio-links"]},"post":{"operationId":"createBlock","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBlockDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Add a block","tags":["bio-links"]}},"/api/v1/bio/blocks/{id}":{"patch":{"operationId":"updateBlock","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateBlockDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update a block","tags":["bio-links"]},"delete":{"operationId":"deleteBlock","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a block","tags":["bio-links"]}},"/api/v1/bio/blocks/reorder":{"put":{"operationId":"reorderBlocks","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReorderBlocksDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Reorder blocks (ordered id list)","tags":["bio-links"]}},"/api/v1/bio/public/blocks/{blockId}/pay":{"post":{"operationId":"createOrder","parameters":[{"name":"blockId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"summary":"Create paid-link order (invoice)","tags":["paid-links"]}},"/api/v1/bio/public/orders/{orderId}":{"get":{"operationId":"getOrder","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Order status (poll for payment)","tags":["paid-links"]}},"/api/v1/bio/public/unlock/{token}":{"get":{"operationId":"unlock","parameters":[{"name":"token","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Unlock purchased content","tags":["paid-links"]}},"/api/v1/bio/profiles":{"get":{"operationId":"listProfiles","parameters":[{"name":"q","required":false,"in":"query","schema":{"type":"string"}},{"name":"sort","required":false,"in":"query","schema":{"enum":["boosted","new","zaps"],"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Public bio-profile directory — boosted first, then newest","tags":["bio-links"]}},"/api/v1/bio/boost-products":{"get":{"operationId":"getBoostProducts","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Available profile boost products","tags":["bio-links"]}},"/api/v1/bio/boost":{"post":{"operationId":"createBoost","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoostProfileDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Boost my bio page (plan credit first, invoice for the rest)","tags":["bio-links"]}},"/api/v1/bio/boosts":{"get":{"operationId":"listMyBoosts","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"My profile boosts","tags":["bio-links"]}},"/api/v1/bio/boost/active":{"get":{"operationId":"getActiveBoost","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Active boost for my page (null when not boosted)","tags":["bio-links"]}},"/api/v1/bio/boosts/{id}/check":{"post":{"operationId":"checkBoost","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Poll boost payment → activate","tags":["bio-links"]}},"/api/v1/billing/subscription":{"get":{"operationId":"getSubscription","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Subscription retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get current subscription","tags":["Billing"]}},"/api/v1/billing/subscription/cancel":{"post":{"operationId":"cancelSubscription","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Subscription cancelled successfully"}},"security":[{"bearer":[]}],"summary":"Cancel subscription","tags":["Billing"]}},"/api/v1/billing/plans/catalog":{"get":{"operationId":"getPlans","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"The 4 platform tiers + sats pricing + features + entitlements (public — single source of truth for pricing pages)","tags":["Plans & Billing"]}},"/api/v1/billing/billing/plan":{"get":{"operationId":"getMyPlan","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"My current plan + entitlements (boost credit included)","tags":["Plans & Billing"]}},"/api/v1/billing/billing/checkout":{"post":{"operationId":"checkout","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a sats invoice for a tier (minted on the platform wallet). payNow pays from my wallet.","tags":["Plans & Billing"]}},"/api/v1/billing/billing/invoices/{id}/check":{"post":{"operationId":"checkInvoice","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Poll invoice settlement → activate/extend the plan","tags":["Plans & Billing"]}},"/api/v1/billing/billing/invoices":{"get":{"operationId":"listInvoices","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"My subscription payment history","tags":["Plans & Billing"]}},"/api/v1/billing/billing/cancel":{"post":{"operationId":"cancel","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Cancel renewal — the tier stays until the paid period ends","tags":["Plans & Billing"]}},"/api/v1/admin/plans/users":{"get":{"operationId":"listUsers","parameters":[{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"tier","required":false,"in":"query","schema":{"enum":["free","zap","pro","business"],"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Users + their plans (search, filter by tier)","tags":["Admin Plans"]}},"/api/v1/admin/plans/users/{userId}":{"get":{"operationId":"getUser","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"One user: plan + merged entitlements + invoice history","tags":["Admin Plans"]}},"/api/v1/admin/plans/users/{userId}/tier":{"patch":{"operationId":"setTier","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSetTierDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Set a user's tier manually (gift/comp/downgrade, no payment)","tags":["Admin Plans"]}},"/api/v1/admin/plans/users/{userId}/extend":{"post":{"operationId":"extend","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminExtendPeriodDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Extend (negative: shorten) the current paid period","tags":["Admin Plans"]}},"/api/v1/admin/plans/users/{userId}/overrides":{"patch":{"operationId":"setOverrides","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOverridesDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Set/merge per-user entitlement overrides — increase/decrease any quota (null clears a key)","tags":["Admin Plans"]},"delete":{"operationId":"clearOverrides","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Clear ALL overrides — back to pure tier defaults","tags":["Admin Plans"]}},"/api/v1/admin/plans/users/{userId}/boost-credit":{"post":{"operationId":"grantBoostCredit","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminBoostCreditDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Grant extra free-boost credit this period","tags":["Admin Plans"]}},"/api/v1/splits/rules":{"get":{"operationId":"getRule","parameters":[{"name":"projectId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get the split rule for a project","tags":["Splits"]},"put":{"description":"Targets are lightning addresses with a percent each (sum ≤ 100%). Every settled project invoice pays out the shares automatically; the remainder stays with you.","operationId":"upsertRule","parameters":[{"name":"projectId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Rule saved"}},"security":[{"bearer":[]}],"summary":"Create or replace the split rule for a project","tags":["Splits"]},"delete":{"operationId":"deleteRule","parameters":[{"name":"projectId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete the split rule for a project","tags":["Splits"]}},"/api/v1/splits/executions":{"get":{"operationId":"listExecutions","parameters":[{"name":"projectId","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"offset","required":false,"in":"query","schema":{"type":"number"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Split payout history for a project","tags":["Splits"]}},"/api/v1/gift-cards":{"post":{"operationId":"issue","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateGiftCardDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Issue a gift card (paid = purchase invoice, free = merchant-funded)","tags":["gift-cards"]},"get":{"operationId":"list","parameters":[{"name":"projectId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my gift cards","tags":["gift-cards"]}},"/api/v1/gift-cards/{id}":{"get":{"operationId":"detail","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Gift card detail (with redemption history)","tags":["gift-cards"]}},"/api/v1/gift-cards/{id}/disable":{"post":{"operationId":"disable","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Disable a gift card (stop further redemptions)","tags":["gift-cards"]}},"/api/v1/gift-cards/public/{code}":{"get":{"operationId":"getPublic","parameters":[{"name":"code","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Check a gift card by code (balance, status, redeem LNURL)","tags":["gift-cards"]}},"/api/v1/gift-cards/public/{code}/check-purchase":{"post":{"operationId":"checkPurchase","parameters":[{"name":"code","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"summary":"Poll a paid card’s purchase settlement (activates on payment)","tags":["gift-cards"]}},"/api/v1/gift-cards/public/{code}/redeem":{"post":{"operationId":"redeem","parameters":[{"name":"code","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedeemGiftCardDto"}}}},"responses":{"201":{"description":""}},"summary":"Redeem from a gift card — returns the LNURL-withdraw the recipient claims into their own wallet","tags":["gift-cards"]}},"/api/v1/my-wallet/withdrawals":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWithdrawalDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Withdraw sats (BOLT11 / lightning address / LNURL)","tags":["withdrawals"]},"get":{"operationId":"findAll","parameters":[{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"offset","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Withdrawal history","tags":["withdrawals"]}},"/api/v1/my-wallet/withdrawals/limits":{"get":{"operationId":"getLimits","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Current velocity-limit usage","tags":["withdrawals"]}},"/api/v1/my-wallet/withdrawals/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Withdrawal detail (incl. preimage proof)","tags":["withdrawals"]}},"/api/v1/my-wallet/withdraw-links":{"post":{"description":"Creates a scannable voucher: anyone with the LNURL/QR can pull the fixed amount from your wallet, up to `uses` times. Sats stay in your wallet until actually claimed.","operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":"Link created"},"400":{"description":"Invalid params, insufficient balance, or link limit reached"}},"security":[{"bearer":[]}],"summary":"Create an LNURL-withdraw link","tags":["LNURL Withdraw Links"]},"get":{"operationId":"findAll","parameters":[{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my withdraw links","tags":["LNURL Withdraw Links"]}},"/api/v1/my-wallet/withdraw-links/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"404":{"description":"Link not found"}},"security":[{"bearer":[]}],"summary":"Withdraw link detail (current used count)","tags":["LNURL Withdraw Links"]},"delete":{"description":"Unclaimed sats stay in the wallet.","operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"404":{"description":"Link not found"}},"security":[{"bearer":[]}],"summary":"Delete a withdraw link","tags":["LNURL Withdraw Links"]}},"/api/v1/payment-links":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePaymentLinkDto"}}}},"responses":{"201":{"description":"Payment link created successfully"}},"security":[{"bearer":[]}],"summary":"Create a new payment link (creates real LNURL-pay link on LNbits)","tags":["Payment Links"]},"get":{"operationId":"findAll","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"isQuickLink","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Payment links retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get all payment links","tags":["Payment Links"]}},"/api/v1/payment-links/public/{shortId}":{"get":{"operationId":"findByShortId","parameters":[{"name":"shortId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Payment link retrieved successfully"},"404":{"description":"Payment link not found"}},"summary":"Get payment link by short ID (public access)","tags":["Payment Links"]}},"/api/v1/payment-links/public/{shortId}/lnurl":{"get":{"operationId":"getLnurlParams","parameters":[{"name":"shortId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Get LNURL-pay params for a payment link (public)","tags":["Payment Links"]}},"/api/v1/payment-links/public/{shortId}/invoice":{"post":{"operationId":"requestInvoice","parameters":[{"name":"shortId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"summary":"Request an invoice for a payment link (public) — offers auto-apply; couponCode optional","tags":["Payment Links"]}},"/api/v1/payment-links/public/{shortId}/verify":{"get":{"operationId":"checkInvoiceStatus","parameters":[{"name":"shortId","required":true,"in":"path","schema":{"type":"string"}},{"name":"url","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Check invoice payment status via verify URL (public)","tags":["Payment Links"]}},"/api/v1/payment-links/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Payment link retrieved successfully"},"404":{"description":"Payment link not found"}},"security":[{"bearer":[]}],"summary":"Get a single payment link","tags":["Payment Links"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Payment link deleted successfully"},"404":{"description":"Payment link not found"}},"security":[{"bearer":[]}],"summary":"Delete a payment link (also deletes LNURL-pay link on LNbits)","tags":["Payment Links"]}},"/api/v1/payment-links/{id}/status":{"patch":{"operationId":"updateStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Payment link status updated successfully"}},"security":[{"bearer":[]}],"summary":"Update payment link status","tags":["Payment Links"]}},"/api/v1/payment-links/{id}/qrcode":{"get":{"operationId":"getQRCode","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"QR code generated successfully"},"404":{"description":"Payment link not found"}},"security":[{"bearer":[]}],"summary":"Get QR code for payment link","tags":["Payment Links"]}},"/api/v1/wallet/info":{"get":{"operationId":"getWalletInfo","parameters":[{"name":"providerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Wallet info retrieved"}},"security":[{"bearer":[]}],"summary":"Get wallet info and balance","tags":["Wallet"]}},"/api/v1/wallet/wallets":{"get":{"operationId":"getWallets","parameters":[{"name":"providerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List all wallets of the user","tags":["Wallet"]},"post":{"operationId":"createWallet","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a new wallet","tags":["Wallet"]}},"/api/v1/wallet/accounts":{"post":{"operationId":"createAccount","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a new account (user + wallet) for other users","tags":["Wallet"]}},"/api/v1/wallet/payments":{"get":{"operationId":"getPayments","parameters":[{"name":"providerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get wallet payments","tags":["Wallet"]}},"/api/v1/wallet/payments/history":{"get":{"operationId":"getPaymentsHistory","parameters":[{"name":"group","required":false,"in":"query","schema":{"enum":["hour","day","month"],"type":"string"}},{"name":"providerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get payments history for charts","tags":["Wallet"]}},"/api/v1/wallet/payments/{paymentHash}/status":{"get":{"operationId":"checkPaymentStatus","parameters":[{"name":"paymentHash","required":true,"in":"path","schema":{"type":"string"}},{"name":"providerId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Check payment status","tags":["Wallet"]}},"/api/v1/wallet/invoices":{"post":{"operationId":"createInvoice","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create invoice (receive sats)","tags":["Wallet"]}},"/api/v1/wallet/pay":{"post":{"operationId":"payInvoice","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Pay a BOLT11 invoice (send sats)","tags":["Wallet"]}},"/api/v1/wallet/pay/lnurl":{"post":{"operationId":"payLnurl","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Pay an LNURL or lightning address","tags":["Wallet"]}},"/api/v1/wallet/lnurl/scan":{"post":{"operationId":"lnurlScan","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Scan/decode an LNURL or lightning address","tags":["Wallet"]}},"/api/v1/wallet/decode":{"post":{"operationId":"decodeInvoice","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Decode a BOLT11 invoice","tags":["Wallet"]}},"/api/v1/wallet/rates/{currency}":{"get":{"operationId":"getExchangeRate","parameters":[{"name":"currency","required":true,"in":"path","schema":{"type":"string"}},{"name":"providerId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get exchange rate for a currency","tags":["Wallet"]}},"/api/v1/wallet/convert":{"post":{"operationId":"convert","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Convert fiat to sats or vice versa","tags":["Wallet"]}},"/api/v1/wallet/currencies":{"get":{"operationId":"getCurrencies","parameters":[{"name":"providerId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List available currencies","tags":["Wallet"]}},"/api/v1/wallet/qrcode":{"get":{"operationId":"generateQRCode","parameters":[{"name":"data","required":true,"in":"query","schema":{"type":"string"}},{"name":"providerId","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Generate QR code for arbitrary data","tags":["Wallet"]}},"/api/v1/my-wallet/overview":{"get":{"operationId":"getOverview","parameters":[{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Aggregated wallet dashboard: info + payments + history + links + withdrawals + lndhub in ONE call (10s cache)","tags":["My Wallet"]}},"/api/v1/lndhub/credentials":{"get":{"operationId":"status","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"LNDHub status for my wallet","tags":["lndhub"]},"post":{"description":"Generates the lndhub:// connection URI for BlueWallet/Zeus. Rotating invalidates the old password.","operationId":"enable","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Enable (or rotate) LNDHub — returns the password ONCE","tags":["lndhub"]},"delete":{"operationId":"disable","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Disable LNDHub access","tags":["lndhub"]}},"/api/v1/lndhub/ext/getinfo":{"get":{"operationId":"getInfo","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Public LNDHub info (alias/version)","tags":["lndhub"]}},"/api/v1/lndhub/ext/auth":{"post":{"operationId":"auth","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"summary":"LNDHub auth — exchange login/password (or refresh_token) for tokens","tags":["lndhub"]}},"/api/v1/lndhub/ext/balance":{"get":{"operationId":"getBalance","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Wallet balance (sats)","tags":["lndhub"]}},"/api/v1/lndhub/ext/addinvoice":{"post":{"operationId":"addInvoice","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create invoice","tags":["lndhub"]}},"/api/v1/lndhub/ext/payinvoice":{"post":{"operationId":"payInvoice","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Pay a BOLT11 invoice","tags":["lndhub"]}},"/api/v1/lndhub/ext/gettxs":{"get":{"operationId":"getTxs","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Outgoing payments (sends)","tags":["lndhub"]}},"/api/v1/lndhub/ext/getuserinvoices":{"get":{"operationId":"getUserInvoices","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Incoming invoices (receives)","tags":["lndhub"]}},"/api/v1/lndhub/ext/getbtc":{"get":{"operationId":"getBtc","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"On-chain deposit address (unsupported — Lightning only)","tags":["lndhub"]}},"/api/v1/lndhub/ext/getpending":{"get":{"operationId":"getPending","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Pending on-chain transactions (unsupported)","tags":["lndhub"]}},"/api/v1/lndhub/ext/decodeinvoice":{"get":{"operationId":"decodeInvoice","parameters":[{"name":"invoice","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Decode a payment request","tags":["lndhub"]}},"/api/v1/lndhub/ext/checkrouteinvoice":{"get":{"operationId":"checkRouteInvoice","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Route check (not implemented, same as canonical)","tags":["lndhub"]}},"/api/v1/lightning-address/domains":{"get":{"operationId":"getDomains","parameters":[{"name":"providerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Domains retrieved"}},"security":[{"bearer":[]}],"summary":"List available NIP-5 domains","tags":["Lightning Addresses"]}},"/api/v1/lightning-address/search":{"get":{"operationId":"searchIdentifier","parameters":[{"name":"domainId","required":true,"in":"query","schema":{"type":"string"}},{"name":"identifier","required":true,"in":"query","schema":{"type":"string"}},{"name":"providerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Search identifier availability on a domain","tags":["Lightning Addresses"]}},"/api/v1/lightning-address":{"post":{"operationId":"register","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":"Lightning address registered"},"409":{"description":"Address already taken"}},"security":[{"bearer":[]}],"summary":"Register a lightning address","tags":["Lightning Addresses"]},"get":{"operationId":"findAll","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my lightning addresses","tags":["Lightning Addresses"]}},"/api/v1/lightning-address/sync":{"get":{"operationId":"sync","parameters":[{"name":"providerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Sync addresses from LNbits","tags":["Lightning Addresses"]}},"/api/v1/lightning-address/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get a lightning address","tags":["Lightning Addresses"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a lightning address","tags":["Lightning Addresses"]}},"/api/v1/lightning-address/{id}/qrcode":{"get":{"operationId":"getQRCode","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get QR code for a lightning address","tags":["Lightning Addresses"]}},"/api/v1/lightning-address/{id}/toggle":{"patch":{"operationId":"toggleActive","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Toggle lightning address active state","tags":["Lightning Addresses"]}},"/api/v1/lightning-address/{id}/wallet":{"patch":{"description":"Set `providerId` to receive on a connected external LNbits provider (BYO wallet), `accountWalletId` to receive on a specific account wallet, or neither to reset to the default platform-provisioned wallet. Only one of the two may be set. Ownership of both the address and the target wallet/provider is verified.","operationId":"linkWallet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkWalletDto"}}}},"responses":{"200":{"description":"Wallet link updated."}},"security":[{"bearer":[]}],"summary":"Link address to the wallet that receives its payments","tags":["Lightning Addresses"]}},"/api/v1/lnurl/params/{username}":{"get":{"operationId":"getPayParams","parameters":[{"name":"username","required":true,"in":"path","schema":{"type":"string"}},{"name":"x-served-domain","required":true,"in":"header","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"LNURL-pay params for a lightning address","tags":["lnurl"]}},"/api/v1/lnurl/callback/{username}":{"get":{"operationId":"handleCallback","parameters":[{"name":"username","required":true,"in":"path","schema":{"type":"string"}},{"name":"x-served-domain","required":true,"in":"header","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"LNURL-pay callback — issue BOLT11 invoice","tags":["lnurl"]}},"/api/v1/lnurl/verify/{paymentHash}":{"get":{"operationId":"verifyPayment","parameters":[{"name":"paymentHash","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"LUD-21 payment verification","tags":["lnurl"]}},"/api/v1/lnurl/nip05":{"get":{"operationId":"getNip05","parameters":[{"name":"name","required":true,"in":"query","schema":{"type":"string"}},{"name":"x-served-domain","required":true,"in":"header","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"NIP-05 nostr identity lookup","tags":["lnurl"]}},"/api/v1/lnurl/availability/{username}":{"get":{"description":"First-party domains only (zapapi.app + SERVED_DOMAINS). For marketplace domains use GET /marketplace/search — it fans out live to each domain provider.","operationId":"checkAvailability","parameters":[{"name":"username","required":true,"in":"path","schema":{"type":"string"}},{"name":"domain","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Check lightning address username availability","tags":["lnurl"]}},"/api/v1/lnurl/claim":{"post":{"operationId":"claim","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimAddressDto"}}}},"responses":{"201":{"description":"Address claimed"},"409":{"description":"Username taken or reserved"}},"security":[{"bearer":[]}],"summary":"Claim your name@domain lightning address (free)","tags":["lnurl"]},"get":{"operationId":"getMyClaim","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get my claimed lightning address","tags":["lnurl"]},"patch":{"operationId":"updateClaim","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateClaimedAddressDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update my claimed address (pubkey, relays)","tags":["lnurl"]},"delete":{"operationId":"releaseClaim","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Release my claimed address","tags":["lnurl"]}},"/api/v1/lnurl/claim/pubkey-challenge":{"post":{"description":"Sign a kind 27235 event with tags [[\"challenge\", c]] and pass it as pubkeyProof when claiming or updating the pubkey.","operationId":"pubkeyChallenge","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Get a challenge to prove nostr pubkey ownership (NIP-05)","tags":["lnurl"]}},"/api/v1/nwc/connections":{"get":{"operationId":"list","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my NWC connections","tags":["NWC"]},"post":{"description":"Generates a nostr+walletconnect:// URI with per-connection permissions, budget (sats + period) and optional expiry. The client secret is never shown again.","operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":"Connection created"}},"security":[{"bearer":[]}],"summary":"Create a NWC connection — URI shown ONCE","tags":["NWC"]}},"/api/v1/nwc/connections/{id}":{"delete":{"operationId":"revoke","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"404":{"description":"Connection not found"}},"security":[{"bearer":[]}],"summary":"Revoke a connection","tags":["NWC"]}},"/api/v1/paywalls/public/{shortId}":{"get":{"operationId":"getPublicView","parameters":[{"name":"shortId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Public paywall view (title, price — no destination)","tags":["Paywalls"]}},"/api/v1/paywalls/public/{shortId}/invoice":{"post":{"operationId":"createInvoice","parameters":[{"name":"shortId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Issue an invoice for this paywall (public)","tags":["Paywalls"]}},"/api/v1/paywalls/public/{shortId}/access":{"get":{"operationId":"checkAccess","parameters":[{"name":"shortId","required":true,"in":"path","schema":{"type":"string"}},{"name":"paymentHash","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Check access — reveals the destination when the invoice is paid","tags":["Paywalls"]}},"/api/v1/paywalls":{"post":{"description":"Protect a URL behind a Lightning payment. Payers see title + price; the destination is revealed only after payment.","operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":"Paywall created"}},"security":[{"bearer":[]}],"summary":"Create a paywall","tags":["Paywalls"]},"get":{"operationId":"findAll","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my paywalls","tags":["Paywalls"]}},"/api/v1/paywalls/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Paywall detail (incl. destination — owner only)","tags":["Paywalls"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a paywall","tags":["Paywalls"]}},"/api/v1/paywalls/{id}/status":{"patch":{"operationId":"updateStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Enable or disable a paywall","tags":["Paywalls"]}},"/api/v1/relay-passes/public/{shortId}":{"get":{"operationId":"getPublicView","parameters":[{"name":"shortId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Public pass view (title, price, relay)","tags":["Relay Passes"]}},"/api/v1/relay-passes/public/{shortId}/invoice":{"post":{"operationId":"createInvoice","parameters":[{"name":"shortId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Issue an invoice for a buyer pubkey (public)","tags":["Relay Passes"]}},"/api/v1/relay-passes/public/{shortId}/grant":{"get":{"operationId":"checkGrant","parameters":[{"name":"shortId","required":true,"in":"path","schema":{"type":"string"}},{"name":"paymentHash","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Buyer checks if their payment settled","tags":["Relay Passes"]}},"/api/v1/relay-passes/public/{shortId}/access/{pubkey}":{"get":{"operationId":"checkAccess","parameters":[{"name":"shortId","required":true,"in":"path","schema":{"type":"string"}},{"name":"pubkey","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Relay allowlist check — is this pubkey a current member? (called by relay auth plugins)","tags":["Relay Passes"]}},"/api/v1/relay-passes":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a relay access pass","tags":["Relay Passes"]},"get":{"operationId":"findAll","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my relay passes","tags":["Relay Passes"]}},"/api/v1/relay-passes/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Relay pass detail","tags":["Relay Passes"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a relay pass","tags":["Relay Passes"]}},"/api/v1/relay-passes/{id}/grants":{"get":{"operationId":"listGrants","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Recent buyer grants for this pass","tags":["Relay Passes"]}},"/api/v1/relay-passes/{id}/status":{"patch":{"operationId":"updateStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Enable/disable a relay pass","tags":["Relay Passes"]}},"/api/v1/events/public/{id}":{"get":{"operationId":"getPublicView","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Public event view (name, price, availability)","tags":["Events"]}},"/api/v1/events/public/{id}/tickets":{"post":{"operationId":"buyTicket","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Buy a ticket (public)","tags":["Events"]}},"/api/v1/events/public/tickets/{ticketId}":{"get":{"operationId":"getTicket","parameters":[{"name":"ticketId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Buyer ticket view — reveals the check-in QR code once paid","tags":["Events"]}},"/api/v1/events":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":"Event created"}},"security":[{"bearer":[]}],"summary":"Create an event with paid tickets","tags":["Events"]},"get":{"operationId":"findAll","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my events","tags":["Events"]}},"/api/v1/events/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Event detail (owner)","tags":["Events"]}},"/api/v1/events/{id}/cancel":{"patch":{"operationId":"cancel","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Cancel an event (stops ticket sales)","tags":["Events"]}},"/api/v1/events/{id}/tickets":{"get":{"operationId":"listTickets","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List tickets for an event (owner)","tags":["Events"]}},"/api/v1/events/{id}/check-in":{"put":{"description":"Scan the buyer ticket QR (checkCode) at the door. Returns checked-in, already, unpaid or invalid.","operationId":"checkIn","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"code","required":true,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Check in a ticket by QR code","tags":["Events"]}},"/api/v1/calendar/public/schedules/{id}":{"get":{"operationId":"getPublicView","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Public schedule view with availability","tags":["Calendar"]}},"/api/v1/calendar/public/schedules/{id}/book":{"post":{"operationId":"book","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Book a slot (public)","tags":["Calendar"]}},"/api/v1/calendar/public/appointments/{id}":{"get":{"operationId":"checkAppointment","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Appointment confirmation check (public)","tags":["Calendar"]}},"/api/v1/calendar/schedules":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":"Schedule created"}},"security":[{"bearer":[]}],"summary":"Create a paid schedule","tags":["Calendar"]},"get":{"operationId":"findAll","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my schedules","tags":["Calendar"]}},"/api/v1/calendar/schedules/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Schedule detail (owner)","tags":["Calendar"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a schedule","tags":["Calendar"]}},"/api/v1/calendar/schedules/{id}/status":{"patch":{"operationId":"updateStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Enable or disable a schedule","tags":["Calendar"]}},"/api/v1/calendar/schedules/{id}/appointments":{"get":{"operationId":"listAppointments","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Appointments for a schedule (owner)","tags":["Calendar"]}},"/api/v1/calendar/schedules/{id}/unavailable":{"post":{"operationId":"blockTime","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Block a period (vacation, conflicts)","tags":["Calendar"]}},"/api/v1/calendar/schedules/{id}/unavailable/{blockedId}":{"delete":{"operationId":"unblockTime","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"blockedId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Unblock a period","tags":["Calendar"]}},"/api/v1/tabs/public/{id}":{"get":{"operationId":"getPublicView","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Public tab view — balance + recent entries","tags":["Tabs"]}},"/api/v1/tabs/public/{id}/settle":{"post":{"operationId":"createSettlement","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Pay (part of) the tab balance (public)","tags":["Tabs"]}},"/api/v1/tabs/public/settlements/{settlementId}":{"get":{"operationId":"checkSettlement","parameters":[{"name":"settlementId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Settlement confirmation check (public)","tags":["Tabs"]}},"/api/v1/tabs":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":"Tab created"}},"security":[{"bearer":[]}],"summary":"Open a tab","tags":["Tabs"]},"get":{"operationId":"findAll","parameters":[{"name":"includeArchived","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my tabs","tags":["Tabs"]}},"/api/v1/tabs/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Tab detail (owner)","tags":["Tabs"]}},"/api/v1/tabs/{id}/status":{"patch":{"operationId":"updateStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Close or reopen a tab","tags":["Tabs"]}},"/api/v1/tabs/{id}/archive":{"patch":{"operationId":"archive","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Archive a tab","tags":["Tabs"]}},"/api/v1/tabs/{id}/entries":{"get":{"operationId":"listEntries","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Tab entries (owner)","tags":["Tabs"]},"post":{"description":"Charge increases the balance; credit decreases it (comp, correction). Enforces the tab limit when set.","operationId":"addEntry","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Add a charge or credit to the tab","tags":["Tabs"]}},"/api/v1/tabs/{id}/settlements":{"get":{"operationId":"listSettlements","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Tab settlements (owner)","tags":["Tabs"]}},"/api/v1/tabs/{id}/settlements/{settlementId}":{"delete":{"operationId":"cancelSettlement","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"settlementId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Cancel a pending settlement","tags":["Tabs"]}},"/api/v1/swaps/info":{"get":{"description":"Boltz reachability + current min/max sats and fee structure for both directions.","operationId":"getInfo","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Swap availability, limits and fees","tags":["Swaps"]}},"/api/v1/swaps":{"get":{"operationId":"findAll","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my swaps","tags":["Swaps"]}},"/api/v1/swaps/submarine":{"post":{"description":"Creates a Boltz swap and pays its invoice from your wallet. Boltz sends on-chain; track progress via the status endpoint. Set BOLTZ_ENABLED=false to disable platform-wide.","operationId":"createSubmarine","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":"Swap created + invoice paid"},"400":{"description":"Invalid address, out of limits, or payment failed"}},"security":[{"bearer":[]}],"summary":"Submarine swap — withdraw sats to a Bitcoin address","tags":["Swaps"]}},"/api/v1/swaps/reverse":{"post":{"description":"Returns a lockup address + BIP21. Send on-chain BTC there; Boltz pays your wallet on confirmation.","operationId":"createReverse","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":"Lockup address returned"}},"security":[{"bearer":[]}],"summary":"Reverse swap — deposit on-chain BTC into your wallet","tags":["Swaps"]}},"/api/v1/swaps/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Swap detail","tags":["Swaps"]}},"/api/v1/swaps/{id}/refresh":{"post":{"description":"Maps Boltz lifecycle (invoice.paid → transaction.mempool → confirmed → done) onto the swap record.","operationId":"refresh","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Poll the Boltz status and update the swap","tags":["Swaps"]}},"/api/v1/watchonly/wallets":{"post":{"description":"Parses + validates the xpub (xpub/ypub/zpub, or tpub/upub/vpub on testnet), stores it encrypted, and derives the first receive addresses. Zero private key material.","operationId":"importXpub","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":"Wallet imported"}},"security":[{"bearer":[]}],"summary":"Import an xpub (watch-only wallet)","tags":["Watch-Only"]},"get":{"operationId":"findAll","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List my watch-only wallets","tags":["Watch-Only"]}},"/api/v1/watchonly/wallets/{id}":{"get":{"operationId":"findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Wallet detail","tags":["Watch-Only"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a watch-only wallet","tags":["Watch-Only"]}},"/api/v1/watchonly/wallets/{id}/addresses":{"get":{"operationId":"listAddresses","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List derived addresses (with balances)","tags":["Watch-Only"]}},"/api/v1/watchonly/wallets/{id}/addresses/fresh":{"post":{"operationId":"freshAddress","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"note","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Fresh receive address (reuses the newest unused one, else derives next)","tags":["Watch-Only"]}},"/api/v1/watchonly/wallets/{id}/refresh":{"post":{"description":"Best-effort: updates every address + the cached wallet total.","operationId":"refreshBalances","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Refresh balances from mempool.space","tags":["Watch-Only"]}},"/api/v1/watchonly/wallets/{id}/psbt":{"post":{"description":"Gathers confirmed UTXOs across the wallet, builds a BIP-174 PSBT with witness_utxo per input for external signing (Sparrow, Coldcard, Ledger). Change returns to a fresh address.","operationId":"buildPsbt","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Build a PSBT spending to a destination (p2wpkh wallets)","tags":["Watch-Only"]}},"/api/v1/marketplace/providers":{"get":{"operationId":"getProviders","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Public provider catalog (active providers + their domains)","tags":["Marketplace"]}},"/api/v1/marketplace/search":{"get":{"operationId":"search","parameters":[{"name":"q","required":true,"in":"query","description":"Name to look up across all providers","schema":{"type":"string","examples":["alice"]}},{"name":"years","required":false,"in":"query","description":"Registration term in years (per-domain max applies)","schema":{"type":"number","examples":[1]}},{"name":"availableOnly","required":false,"in":"query","schema":{"type":"boolean","examples":[true]}},{"name":"sort","required":false,"in":"query","schema":{"enum":["price","domain"],"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Aggregated address search — one query fanned out to every active provider (free first-party first, then cheapest)","tags":["Marketplace"]}},"/api/v1/marketplace/providers/apply":{"post":{"operationId":"apply","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyProviderDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Apply to list your LNbits nostrnip5 domains — instant health-check, then pending admin review","tags":["Marketplace"]}},"/api/v1/marketplace/my-providers":{"get":{"operationId":"myProviders","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"My provider applications and their review status","tags":["Marketplace"]}},"/api/v1/marketplace/my-providers/{id}/stats":{"get":{"operationId":"myProviderStats","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Provider dashboard: my domains + sales receipts (payouts went straight to my domain wallet at purchase time)","tags":["Marketplace"]}},"/api/v1/admin/marketplace/providers":{"post":{"operationId":"register","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterProviderDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Register a provider (health-check + domain import; fails closed if unreachable)","tags":["Admin Marketplace"]},"get":{"operationId":"list","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List all providers (including paused)","tags":["Admin Marketplace"]}},"/api/v1/admin/marketplace/providers/{id}":{"get":{"operationId":"get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Provider detail","tags":["Admin Marketplace"]},"patch":{"operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProviderDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Pause/resume, set commission, rotate invoice key","tags":["Admin Marketplace"]},"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a provider (cascades to its domains and orders)","tags":["Admin Marketplace"]}},"/api/v1/admin/marketplace/providers/{id}/approve":{"post":{"operationId":"approve","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Approve a pending self-serve application → provider goes live","tags":["Admin Marketplace"]}},"/api/v1/admin/marketplace/providers/{id}/reject":{"post":{"operationId":"reject","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RejectProviderDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Reject a pending application with a reason","tags":["Admin Marketplace"]}},"/api/v1/admin/marketplace/providers/{id}/refresh":{"post":{"operationId":"refresh","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Re-import the provider domain catalog now","tags":["Admin Marketplace"]}},"/api/v1/marketplace/orders":{"post":{"operationId":"create","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMarketplaceOrderDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Reserve at the provider + return the invoice (minted on the provider domain wallet). First-party rows claim free + instantly. Returns { requote } instead when the price drifted >5% from the search quote.","tags":["Marketplace Orders"]},"get":{"operationId":"list","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"My orders across all providers","tags":["Marketplace Orders"]}},"/api/v1/marketplace/orders/{id}":{"get":{"operationId":"get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Order detail","tags":["Marketplace Orders"]},"delete":{"operationId":"cancel","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Cancel a reserved (unpaid) order — local only, reservations are soft provider-side","tags":["Marketplace Orders"]}},"/api/v1/marketplace/orders/{id}/pay":{"post":{"operationId":"pay","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"walletId","required":false,"in":"query","description":"Pay from a specific account wallet (default = my default wallet)","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Pay the invoice from my ZapAPI wallet (payment rail — destination is the provider domain wallet). Re-checks availability first: aborts to failed if the name was taken since reservation.","tags":["Marketplace Orders"]}},"/api/v1/marketplace/orders/{id}/check":{"post":{"operationId":"check","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Poll activation at the provider. On first activation, the response includes rotationSecret exactly once — save it.","tags":["Marketplace Orders"]}},"/api/v1/marketplace/orders/{id}/publish-verification":{"post":{"operationId":"publishVerification","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishVerificationDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Publish the activated address to my nostr profile (kind 0 nip05 field) — signed with my generated key; unavailable for externally-linked keys (Phase 4)","tags":["Marketplace Orders"]}},"/api/v1/directory/apps":{"get":{"operationId":"listApps","parameters":[{"name":"category","required":false,"in":"query","schema":{"type":"string"}},{"name":"q","required":false,"in":"query","schema":{"type":"string"}},{"name":"sort","required":false,"in":"query","schema":{"enum":["score","new","zaps"],"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Browse the directory (zap-weighted + boosted ranking)","tags":["Directory"]},"post":{"operationId":"submit","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitAppDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Submit an app (pending review). Omit lnAddress to auto-provision app-{slug}@zapapi.app — zaps land in your ZapAPI wallet.","tags":["Directory"]}},"/api/v1/directory/apps/{slug}":{"get":{"operationId":"getApp","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"App detail with live score breakdown","tags":["Directory"]}},"/api/v1/directory/categories":{"get":{"operationId":"getCategories","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Directory categories","tags":["Directory"]}},"/api/v1/directory/boost-products":{"get":{"operationId":"getBoostProducts","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"summary":"Available boost products (sats × days)","tags":["Directory"]}},"/api/v1/directory/my-apps":{"get":{"operationId":"myApps","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"My listings with live stats","tags":["Directory"]}},"/api/v1/directory/apps/{id}":{"patch":{"operationId":"update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAppDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Edit my listing (URL change re-triggers review)","tags":["Directory"]}},"/api/v1/directory/apps/{id}/boost":{"post":{"operationId":"boost","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoostAppDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Boost a listing: invoice on the platform wallet (ZapAPI revenue). payNow=true pays immediately from my wallet.","tags":["Directory"]}},"/api/v1/directory/boosts":{"get":{"operationId":"myBoosts","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"My boosts","tags":["Directory"]}},"/api/v1/directory/boosts/{id}/check":{"post":{"operationId":"checkBoost","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Poll boost payment → activate the boost window","tags":["Directory"]}},"/api/v1/admin/directory/apps":{"get":{"operationId":"list","parameters":[{"name":"status","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"All apps (optionally filtered by status)","tags":["Admin Directory"]}},"/api/v1/admin/directory/apps/{id}/approve":{"post":{"operationId":"approve","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Approve a pending listing → live in the directory","tags":["Admin Directory"]}},"/api/v1/admin/directory/apps/{id}/reject":{"post":{"operationId":"reject","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RejectAppDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Reject a pending listing with a reason","tags":["Admin Directory"]}},"/api/v1/admin/directory/apps/{id}/feature":{"post":{"operationId":"feature","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Pin (featured) or unpin a listing","tags":["Admin Directory"]}},"/api/v1/admin/directory/apps/{id}":{"delete":{"operationId":"remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a listing from the directory","tags":["Admin Directory"]}},"/api/v1/usage/stats":{"get":{"operationId":"getStats","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"days","required":false,"in":"query","schema":{"type":"number"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Usage statistics retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get usage statistics","tags":["Usage"]}},"/api/v1/usage/current":{"get":{"operationId":"getCurrentUsage","parameters":[{"name":"projectId","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Current usage retrieved successfully"}},"security":[{"bearer":[]}],"summary":"Get current quota usage","tags":["Usage"]}},"/api/v1/ai/chat/completions":{"post":{"operationId":"chatCompletions","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Completion or SSE stream"},"402":{"description":"Insufficient balance"}},"security":[{"bearer":[]}],"summary":"Chat completions (OpenAI-compatible, streaming supported)","tags":["AI Gateway"]}},"/api/v1/ai/models":{"get":{"operationId":"listModels","parameters":[{"name":"type","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List available models with listed pricing","tags":["AI Gateway"]}},"/api/v1/ai/public/models":{"get":{"operationId":"listPublicModels","parameters":[{"name":"type","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Public model catalog with listed pricing (no auth)","tags":["AI Gateway"]}},"/api/v1/ai/balance":{"get":{"operationId":"getBalance","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get AI credit balance (sats)","tags":["AI Account"]}},"/api/v1/ai/rate":{"get":{"operationId":"getRate","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Current BTC/USD rate + FX buffer (live sats pricing)","tags":["AI Account"]}},"/api/v1/ai/topup":{"post":{"operationId":"createTopup","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTopupDto"}}}},"responses":{"201":{"description":"BOLT11 invoice created"}},"security":[{"bearer":[]}],"summary":"Create a Lightning topup invoice for AI credits","tags":["AI Account"]}},"/api/v1/ai/topup/{id}":{"get":{"operationId":"checkTopup","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Check topup status (credits balance when paid)","tags":["AI Account"]}},"/api/v1/ai/topups":{"get":{"operationId":"listTopups","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List recent topups","tags":["AI Account"]}},"/api/v1/ai/auto-topup":{"get":{"operationId":"getAutoTopup","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get NWC auto-topup settings","tags":["AI Account"]},"post":{"operationId":"saveAutoTopup","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveAutoTopupDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Enable NWC auto-topup with threshold, amount and daily cap","tags":["AI Account"]},"delete":{"operationId":"removeAutoTopup","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Disable and remove auto-topup settings","tags":["AI Account"]}},"/api/v1/ai/auto-topup/toggle":{"post":{"operationId":"toggleAutoTopup","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Enable or disable auto-topup","tags":["AI Account"]}},"/api/v1/ai/usage":{"get":{"operationId":"getUsage","parameters":[{"name":"page","required":false,"in":"query","schema":{"type":"number"}},{"name":"pageCount","required":false,"in":"query","schema":{"type":"number"}},{"name":"model","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"AI usage history (per-query cost breakdown)","tags":["AI Account"]}},"/api/v1/ai/usage/summary":{"get":{"operationId":"getUsageSummary","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"AI usage summary (spend, queries, top models)","tags":["AI Account"]}},"/api/v1/ai/admin/sync":{"post":{"operationId":"forceSync","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Force model catalog sync from OpenRouter","tags":["AI Admin"]}},"/api/v1/ai/admin/sync-status":{"get":{"operationId":"syncStatus","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Model catalog sync status","tags":["AI Admin"]}},"/api/v1/ai/admin/models":{"get":{"operationId":"listModels","parameters":[{"name":"type","required":false,"in":"query","schema":{"type":"string"}},{"name":"active","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"q","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Full model catalog (active + inactive) with usage counts","tags":["AI Admin"]}},"/api/v1/ai/admin/models/activate":{"patch":{"operationId":"setActive","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Activate or deactivate a model (body: {id, active})","tags":["AI Admin"]}},"/api/v1/ai/admin/sync-media-pricing":{"post":{"operationId":"syncMediaPricing","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Force per-endpoint pricing enrichment for image/video models","tags":["AI Admin"]}},"/api/v1/ai/admin/stats":{"get":{"operationId":"stats","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Platform AI stats: top models, queries, revenue, margin","tags":["AI Admin"]}},"/api/v1/ai/tools/catalog":{"get":{"operationId":"catalog","parameters":[{"name":"category","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Public tool catalog (indicative sats pricing)","tags":["AI Tools"]}},"/api/v1/ai/tools":{"get":{"operationId":"list","parameters":[{"name":"category","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List available tools with indicative pricing","tags":["AI Tools"]}},"/api/v1/ai/tools/{toolId}/quote":{"post":{"operationId":"quote","parameters":[{"name":"toolId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteToolDto"}}}},"responses":{"200":{"description":"Live quote"}},"security":[{"bearer":[]}],"summary":"Live quote for a tool call (cost, listed price with margin, cap)","tags":["AI Tools"]}},"/api/v1/ai/tools/{toolId}/execute":{"post":{"operationId":"execute","parameters":[{"name":"toolId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteToolDto"}}}},"responses":{"201":{"description":"Tool call record"},"402":{"description":"Insufficient balance"}},"security":[{"bearer":[]}],"summary":"Execute a tool (debits AI credits, pays upstream over Lightning)","tags":["AI Tools"]}},"/api/v1/ai/tools/jobs/{callId}":{"get":{"operationId":"job","parameters":[{"name":"callId","required":true,"in":"path","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Poll an async tool job status / collect result","tags":["AI Tools"]}},"/api/v1/ai/tools/history":{"get":{"operationId":"history","parameters":[{"name":"page","required":false,"in":"query","schema":{"type":"number"}},{"name":"pageCount","required":false,"in":"query","schema":{"type":"number"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Tool call history (per-call cost breakdown)","tags":["AI Tools"]}},"/api/v1/ai/admin/tools":{"get":{"operationId":"listTools","parameters":[{"name":"category","required":false,"in":"query","schema":{"type":"string"}},{"name":"active","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"q","required":false,"in":"query","schema":{"type":"string"}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Full tool catalog (active + inactive) with usage and margin","tags":["AI Tools Admin"]}},"/api/v1/ai/admin/tools/pricing":{"patch":{"operationId":"setPricing","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Set per-tool pricing overrides (body: {id, markupPct?, flatFeeSats?, maxCallSats?}; null clears to global default)","tags":["AI Tools Admin"]}},"/api/v1/ai/admin/tools/activate":{"patch":{"operationId":"setActive","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Activate or deactivate a tool (body: {id, active})","tags":["AI Tools Admin"]}},"/api/v1/ai/admin/tools/sync":{"post":{"operationId":"forceSync","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Force tool catalog sync from Sats4AI","tags":["AI Tools Admin"]}},"/api/v1/ai/admin/tools/sync-status":{"get":{"operationId":"syncStatus","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Tool catalog sync status","tags":["AI Tools Admin"]}},"/api/v1/ai/admin/tools/stats":{"get":{"operationId":"stats","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Tool platform stats: calls, revenue, COGS, margin","tags":["AI Tools Admin"]}},"/api/v1/uploads/handle":{"post":{"description":"Internal endpoint invoked by the `@vercel/blob/client` `upload()` function. Validates the requested pathname, then returns a constrained client token (image types only, 5 MB max, random suffix). Auth: zap_* API key with `uploads:write` scope, or dashboard JWT.","operationId":"handleClientUpload","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":"Client token generated (or upload-completed acknowledged)."}},"security":[{"bearer":[]}],"summary":"Mint client-upload token (used by @vercel/blob/client)","tags":["uploads"]}},"/api/v1/uploads/server":{"post":{"description":"Fallback upload path for API clients (zap_* key with `uploads:write` scope or JWT). Prefer the client-direct flow (`/uploads/handle`) for browsers — it bypasses function size limits and is cheaper.","operationId":"serverUpload","parameters":[{"name":"folder","required":false,"in":"query","schema":{"default":"misc","type":"string","enum":["avatars","banners","blog","misc"],"examples":["avatars"]}},{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"contentMediaType":"application/octet-stream"}}}}}},"responses":{"200":{"description":"File uploaded — returns the public blob URL.","content":{"application/json":{"schema":{"examples":[{"status":"success","statusCode":200,"message":"OK","data":{"url":"https://…public.blob.vercel-storage.com/avatars/u1/pic-aB3dEf.png","pathname":"avatars/u1/pic-aB3dEf.png"},"timestamp":"2026-10-23T10:00:00.000Z","path":"/api/v1/uploads/server"}]}}}}},"security":[{"bearer":[]}],"summary":"Upload an image through the server (≤5 MB)","tags":["uploads"]}},"/api/v1/uploads/status":{"get":{"operationId":"getStatus","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Blob credential status (diagnostic — no secrets exposed)","tags":["uploads"]}},"/api/v1/uploads":{"delete":{"description":"Deletes a blob from the connected store. Call this when replacing/removing images (e.g. old avatar) to avoid orphan storage costs. Auth: zap_* API key with `uploads:write` scope, or dashboard JWT.","operationId":"deleteBlob","parameters":[{"name":"X-API-Version","in":"header","required":false,"description":"API version for header-based versioning","schema":{"type":"string","enum":["1","2"],"default":"1"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteBlobDto"}}}},"responses":{"200":{"description":"Blob deleted."}},"security":[{"bearer":[]}],"summary":"Delete a blob by URL","tags":["uploads"]}}},"info":{"title":"ZapAPI","description":"$217","version":"1.0.0","contact":{"name":"ZapAPI","url":"https://github.com/k-kaundal/zapapi","email":"admin@zapapi.com"},"license":{"name":"MIT","url":"https://opensource.org/licenses/MIT"}},"tags":[{"name":"health","description":"Health check endpoints"},{"name":"auth","description":"Authentication & Authorization endpoints"},{"name":"users","description":"User management endpoints"},{"name":"sessions","description":"Session management endpoints"}],"servers":[{"url":"http://localhost:3001","description":"Local Development"},{"url":"https://api.zapapi.com","description":"Production"}],"components":{"securitySchemes":{"JWT":{"scheme":"bearer","bearerFormat":"JWT","type":"http","name":"JWT","description":"Enter your JWT access token","in":"header"},"API-Key":{"scheme":"bearer","bearerFormat":"API Key","type":"http","name":"API-Key","description":"Scoped API key for server integrations — zap_live_… or zap_test_…","in":"header"}},"schemas":{"TriggerCleanupDto":{"type":"object","properties":{"hours":{"type":"number","description":"Hours threshold for deleting old logs","default":24,"minimum":1,"examples":[24]}}},"RegisterDto":{"type":"object","properties":{"email":{"type":"string","description":"User email address","examples":["john.doe@example.com"]},"firstName":{"type":"string","description":"User first name","minLength":2,"maxLength":50,"examples":["John"]},"lastName":{"type":"string","description":"User last name","minLength":2,"maxLength":50,"examples":["Doe"]},"password":{"type":"string","description":"User password (min 8 chars, must include uppercase, lowercase, number, and special character)","minLength":8,"maxLength":100,"examples":["SecurePass123!"]}},"required":["email","firstName","lastName","password"]},"LoginDto":{"type":"object","properties":{"email":{"type":"string","description":"User email address","examples":["john.doe@example.com"]},"password":{"type":"string","description":"User password","examples":["SecurePass123!"]}},"required":["email","password"]},"RefreshTokenDto":{"type":"object","properties":{"refreshToken":{"type":"string","description":"Valid refresh token","examples":["eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."]}},"required":["refreshToken"]},"ForgotPasswordDto":{"type":"object","properties":{"email":{"type":"string","description":"User email address for password reset","examples":["john.doe@example.com"]}},"required":["email"]},"ResetPasswordDto":{"type":"object","properties":{"token":{"type":"string","description":"Password reset token received via email","examples":["abc123def456ghi789"]},"newPassword":{"type":"string","description":"New password (min 8 chars, must include uppercase, lowercase, number, and special character)","minLength":8,"maxLength":100,"examples":["NewSecurePass123!"]}},"required":["token","newPassword"]},"VerifyEmailDto":{"type":"object","properties":{"token":{"type":"string","description":"Email verification token received via email","examples":["abc123def456ghi789"]}},"required":["token"]},"RevokeSessionDto":{"type":"object","properties":{"sessionId":{"type":"string","description":"Session ID to revoke","examples":["123e4567-e89b-12d3-a456-426614174000"]}},"required":["sessionId"]},"RevokeOtherSessionsDto":{"type":"object","properties":{"currentSessionId":{"type":"string","description":"Current session ID to keep active (optional)","examples":["123e4567-e89b-12d3-a456-426614174000"]}}},"CreateUserDto":{"type":"object","properties":{"email":{"type":"string","description":"User email address","examples":["john.doe@example.com"]},"firstName":{"type":"string","description":"User first name","minLength":2,"maxLength":50,"examples":["John"]},"lastName":{"type":"string","description":"User last name","minLength":2,"maxLength":50,"examples":["Doe"]},"password":{"type":"string","description":"User password (optional - temporary password generated if not provided)","minLength":8,"maxLength":100,"examples":["SecurePass123!"]}},"required":["email","firstName","lastName"]},"UpdateUserDto":{"type":"object","properties":{"email":{"type":"string","description":"User email address","examples":["john.doe@example.com"]},"firstName":{"type":"string","description":"User first name","minLength":2,"maxLength":50,"examples":["John"]},"lastName":{"type":"string","description":"User last name","minLength":2,"maxLength":50,"examples":["Doe"]},"password":{"type":"string","description":"User password (optional - temporary password generated if not provided)","minLength":8,"maxLength":100,"examples":["SecurePass123!"]},"isActive":{"type":"boolean","description":"User active status","examples":[true]},"avatarUrl":{"type":"string","description":"Avatar image URL (Vercel Blob)","examples":["https://yjsm6thumlqlykuv.public.blob.vercel-storage.com/avatars/u1/pic.png"]}}},"BulkUserIdsDto":{"type":"object","properties":{"ids":{"description":"Array of user UUIDs","type":"array","items":{"type":"string"},"examples":[["550e8400-e29b-41d4-a716-446655440000","550e8400-e29b-41d4-a716-446655440001"]]}},"required":["ids"]},"CreateRoleDto":{"type":"object","properties":{"name":{"type":"string","description":"Role name","examples":["Editor"]},"description":{"type":"string","description":"Role description","examples":["Can edit content"]},"permissionIds":{"description":"Permission IDs to assign","type":"array","items":{"type":"string"},"examples":[["perm-uuid-1","perm-uuid-2"]]},"isSystemRole":{"type":"boolean","description":"System role (cannot be deleted)","default":false,"examples":[false]}},"required":["name","description"]},"UpdateRoleDto":{"type":"object","properties":{"name":{"type":"string","description":"Role name","examples":["Editor"]},"description":{"type":"string","description":"Role description","examples":["Can edit content"]},"permissionIds":{"description":"Permission IDs to assign","type":"array","items":{"type":"string"},"examples":[["perm-uuid-1","perm-uuid-2"]]},"isSystemRole":{"type":"boolean","description":"System role (cannot be deleted)","default":false,"examples":[false]}}},"CreatePermissionDto":{"type":"object","properties":{"name":{"type":"string","description":"Permission name","examples":["users:create"]},"description":{"type":"string","description":"Permission description","examples":["Can create users"]},"resource":{"type":"string","description":"Resource name","examples":["users"]},"action":{"type":"string","description":"Action name","examples":["create"]}},"required":["name","description","resource","action"]},"UpdatePermissionDto":{"type":"object","properties":{"name":{"type":"string","description":"Permission name","examples":["users:create"]},"description":{"type":"string","description":"Permission description","examples":["Can create users"]},"resource":{"type":"string","description":"Resource name","examples":["users"]},"action":{"type":"string","description":"Action name","examples":["create"]}}},"AssignRoleDto":{"type":"object","properties":{"roleIds":{"description":"Role IDs to assign to user","type":"array","items":{"type":"string"},"examples":[["role-uuid-1","role-uuid-2"]]}},"required":["roleIds"]},"SubscribeNewsletterDto":{"type":"object","properties":{"email":{"type":"string","description":"Email address to subscribe","examples":["john.doe@example.com"]},"firstName":{"type":"string","description":"First name (optional)","examples":["John"]},"lastName":{"type":"string","description":"Last name (optional)","examples":["Doe"]}},"required":["email"]},"SendNewsletterDto":{"type":"object","properties":{"subject":{"type":"string","description":"Newsletter subject","examples":["Monthly Updates - January 2026"]},"content":{"type":"string","description":"Newsletter HTML content","examples":["

Hello!

Here are our latest updates...

"]}},"required":["subject","content"]},"UpdateSubscriberDto":{"type":"object","properties":{"email":{"type":"string","description":"Subscriber email address","examples":["john.doe@example.com"]},"firstName":{"type":"string","description":"First name","examples":["John"]},"lastName":{"type":"string","description":"Last name","examples":["Doe"]},"isActive":{"type":"boolean","description":"Active status (subscribed / unsubscribed)","examples":[true]}}},"TrackVisitorDto":{"type":"object","properties":{"page":{"type":"string","description":"Page URL","examples":["/about"]},"referrer":{"type":"string","examples":["https://google.com"]},"language":{"type":"string","examples":["en-US"]},"screenWidth":{"type":"number","examples":[1920]},"screenHeight":{"type":"number","examples":[1080]},"sessionId":{"type":"string","examples":["session-uuid"]},"visitDuration":{"type":"number","description":"Visit duration in seconds","examples":[120]}},"required":["page"]},"CreateContactDto":{"type":"object","properties":{"name":{"type":"string","examples":["John Doe"]},"email":{"type":"string","examples":["john@example.com"]},"phone":{"type":"string","examples":["+1234567890"]},"subject":{"type":"string","examples":["General Inquiry"]},"message":{"type":"string","examples":["I would like to know more about your services."]}},"required":["name","email","subject","message"]},"UpdateContactDto":{"type":"object","properties":{"status":{"type":"string","enum":["new","read","replied","archived"],"examples":["read"]}}},"CreateBlogPostDto":{"type":"object","properties":{"title":{"type":"string","minLength":5,"maxLength":200,"examples":["How to Build a Modern Web App"]},"content":{"type":"string","description":"HTML content from rich text editor","examples":["

Introduction

Content here...

Introduction

Content here...

"]},"excerpt":{"type":"string","maxLength":500,"examples":["Learn how to build modern web applications with React and Node.js"]},"featuredImage":{"type":"string","examples":["https://example.com/images/post.jpg"]},"status":{"type":"string","enum":["draft","published","archived"],"default":"draft","examples":["draft"]},"metaDescription":{"type":"string","maxLength":160,"examples":["Build modern web applications with the latest technologies"]},"metaKeywords":{"type":"string","examples":["web development, react, nodejs, tutorial"]},"tags":{"type":"array","items":{"type":"string"},"examples":[["react","nodejs","tutorial"]]},"category":{"type":"string","examples":["Web Development"]}}},"CreateProjectDto":{"type":"object","properties":{"name":{"type":"string","description":"Project name","minLength":3,"maxLength":100,"examples":["E-commerce Store"]},"description":{"type":"string","description":"Project description","examples":["Main production e-commerce store"]},"environment":{"type":"string","description":"Environment type","enum":["development","production"],"default":"development"}},"required":["name","environment"]},"UpdateProjectDto":{"type":"object","properties":{"name":{"type":"string","description":"Project name","examples":["E-commerce Store"]},"description":{"type":"string","description":"Project description"},"status":{"type":"string","description":"Project status","enum":["active","archived"]}}},"CreateProviderDto":{"type":"object","properties":{"name":{"type":"string","description":"Provider name","minLength":3,"maxLength":100,"examples":["LNbits Production"]},"type":{"type":"string","description":"Provider type","enum":["lnbits","nwc","lnd"],"examples":["lnbits"]},"url":{"type":"string","description":"Provider URL","examples":["https://lnbits.example.com"]},"adminKey":{"type":"string","description":"Admin API key (for LNbits)","examples":["your-admin-key-here"]},"invoiceKey":{"type":"string","description":"Invoice API key (for LNbits)","examples":["your-invoice-key-here"]},"apiKey":{"type":"string","description":"API key or connection string (for other providers)","examples":["your-api-key-here"]},"projectId":{"type":"string","description":"Associated project ID","examples":["uuid-of-project"]}},"required":["name","type","url"]},"CreateApiKeyDto":{"type":"object","properties":{"name":{"type":"string","description":"API key name","minLength":3,"maxLength":100,"examples":["Production API Key"]},"environment":{"type":"string","description":"Environment type","enum":["test","live"],"examples":["test"]},"projectId":{"type":"string","description":"Associated project ID","examples":["uuid-of-project"]},"expiresAt":{"type":"string","description":"Expiration date (ISO 8601)","examples":["2025-12-31T23:59:59Z"]},"scopes":{"description":"Permission scopes. Defaults to [\"*\"] (full access). Example: [\"invoices:read\", \"invoices:write\"]","type":"array","items":{"type":"array"},"examples":[["invoices:read","invoices:write"]]}},"required":["name","environment"]},"CreateInvoiceDto":{"type":"object","properties":{"amount":{"type":"number","description":"Amount — in satoshis when currency is \"sat\" (default), or in the fiat currency when currency is e.g. \"USD\"","minimum":1,"examples":[5000]},"currency":{"type":"string","description":"Denomination: \"sat\" (default) or a fiat currency code (USD, EUR, GBP, INR, BRL, JPY, CAD, AUD). Fiat amounts are converted to sats at the current rate, snapshotted at creation.","examples":["sat"]},"description":{"type":"string","description":"Invoice description","examples":["Order #1234"]},"projectId":{"type":"string","description":"Project ID. Optional when the API key is project-scoped (project keys fill this in automatically). The invoice settles to the project's configured settlement wallet.","examples":["uuid-of-project"]},"providerId":{"type":"string","description":"DEPRECATED — settlement is resolved from the project's settlement wallet (dashboard → project → Settlement Wallet). Kept for backward compatibility with legacy LNbits-provider integrations; ignored for new integrations.","deprecated":true,"examples":["uuid-of-provider"]},"expirySeconds":{"type":"number","description":"Expiry time in seconds (default: 3600 = 1 hour)","minimum":60,"maximum":86400,"examples":[3600]},"metadata":{"type":"object","description":"Additional metadata (JSON)","examples":[{"orderId":"1234","customerEmail":"customer@example.com"}]},"couponCode":{"type":"string","description":"Coupon code — the project discount is applied and snapshotted on the invoice (amountDueSats = amount - discountSats). The payer pays amountDueSats.","examples":["LAUNCH20"]},"successUrl":{"type":"string","description":"Merchant success URL — hosted checkout redirects here on payment (paymentHash + preimage appended). Stripe-style success redirect.","examples":["https://shop.example.com/success"]},"cancelUrl":{"type":"string","description":"Merchant cancel/back URL shown on the hosted checkout","examples":["https://shop.example.com/cart"]}},"required":["amount","description"]},"CreateDiscountDto":{"type":"object","properties":{"projectId":{"type":"string","description":"Project the discount applies to"},"mode":{"type":"string","description":"\"coupon\" = customer enters the code at checkout · \"offer\" = applied automatically in its validity window","enum":["coupon","offer"],"default":"coupon"},"code":{"type":"string","description":"Code (uppercased; unique per project)","examples":["LAUNCH20"]},"type":{"type":"string","description":"\"percent\" or \"amount\" (fixed sats off)","enum":["percent","amount"]},"percentOff":{"type":"number","description":"1–99 (when type=percent)"},"amountOffSats":{"type":"number","description":"Fixed sats off (when type=amount)"},"startsAt":{"type":"string","description":"Validity start (ISO; empty = from now)"},"endsAt":{"type":"string","description":"Validity end (ISO; empty = no expiry)"},"maxRedemptions":{"type":"number","description":"Max total redemptions (empty = unlimited)"}},"required":["projectId","code","type"]},"UpdateDiscountDto":{"type":"object","properties":{}},"ValidateCouponDto":{"type":"object","properties":{}},"ResolveOfferDto":{"type":"object","properties":{}},"CreateRefundDto":{"type":"object","properties":{"type":{"type":"string","description":"Refund type: \"credit\" (record only, settle off-band) or \"payment\" (send sats back)","enum":["credit","payment"],"default":"payment"},"amountSats":{"type":"number","description":"Amount in sats to refund. Omit for a full refund of the invoice amount. Partial refunds are allowed.","examples":[5000]},"destination":{"type":"string","description":"Where to send the refund: a BOLT11 invoice or lightning address (name@domain.com). Required for type=payment.","examples":["customer@wallet.com"]},"reason":{"type":"string","description":"Reason for the refund (shown in history)","examples":["Customer requested cancellation"]}},"required":["type"]},"CreateWebhookDto":{"type":"object","properties":{"url":{"type":"string","description":"Webhook endpoint URL (http/https)","examples":["https://api.yourapp.com/webhooks/zapapi"]},"events":{"description":"Events to subscribe to","type":"array","items":{"type":"string"},"examples":[["invoice.paid","invoice.expired"]]},"projectId":{"type":"string","description":"Associated project ID","examples":["uuid-of-project"]}},"required":["url","events","projectId"]},"CreatePlanDto":{"type":"object","properties":{}},"UpdatePlanDto":{"type":"object","properties":{}},"SubscribeDto":{"type":"object","properties":{}},"UpdateCustomerDto":{"type":"object","properties":{}},"UpdatePreferencesDto":{"type":"object","properties":{"emailEnabled":{"type":"boolean"},"emailPayments":{"type":"boolean"},"emailTips":{"type":"boolean"},"emailSubscriptions":{"type":"boolean"},"emailSecurity":{"type":"boolean"},"emailDigest":{"type":"boolean"}}},"CreateNwcConnectionDto":{"type":"object","properties":{"name":{"type":"string","description":"Friendly label for the wallet switcher","examples":["My Alby Hub"]},"connectionString":{"type":"string","description":"Nostr Wallet Connect URI from your wallet (Alby Hub → App Store → Connect app, coinos, Umbrel, LNbits NWC extension, …)","examples":["nostr+walletconnect://69effe7b...?relay=wss://relay.getalby.com/v1&secret=c60320b3..."]}},"required":["name","connectionString"]},"UpdateNwcConnectionDto":{"type":"object","properties":{"name":{"type":"string","examples":["Savings wallet"]}}},"UpsertBioPageDto":{"type":"object","properties":{}},"CreateBlockDto":{"type":"object","properties":{}},"UpdateBlockDto":{"type":"object","properties":{}},"ReorderBlocksDto":{"type":"object","properties":{}},"BoostProfileDto":{"type":"object","properties":{}},"CheckoutDto":{"type":"object","properties":{"tier":{"type":"string","enum":["zap","pro","business"]},"period":{"type":"string","enum":["month","year"],"default":"month"},"payNow":{"type":"boolean","description":"Pay immediately from my ZapAPI wallet"},"walletId":{"type":"string","description":"Pay from a specific account wallet"}},"required":["tier","period"]},"AdminSetTierDto":{"type":"object","properties":{"tier":{"type":"string","enum":["free","zap","pro","business"]},"days":{"type":"number","description":"Days of access to grant (default 30)","default":30},"reason":{"type":"string","description":"Audit note (gift/comp/support reason)"}},"required":["tier"]},"AdminExtendPeriodDto":{"type":"object","properties":{"days":{"type":"number","description":"Days to add (negative to shorten)"}},"required":["days"]},"AdminOverridesDto":{"type":"object","properties":{"overrides":{"type":"object","description":"Entitlement overrides — set a value to override the tier default, set null to clear a key","examples":[{"apiQuota":50000,"maxWallets":5,"marketplaceFeePct":null}]}},"required":["overrides"]},"AdminBoostCreditDto":{"type":"object","properties":{"sats":{"type":"number","description":"Boost credit sats to grant this period"}},"required":["sats"]},"CreateGiftCardDto":{"type":"object","properties":{"balanceSats":{"type":"number","description":"Initial balance in sats","examples":[21000]},"issueType":{"type":"string","description":"\"paid\" = buyer pays a purchase invoice now (card activates on settlement) · \"free\" = merchant-funded comp card (active immediately)","enum":["paid","free"],"default":"paid"},"projectId":{"type":"string","description":"Optional project — paid issuance settles to its settlement wallet"},"expiresAt":{"type":"string","description":"Optional expiry (ISO)"},"note":{"type":"string","description":"Private note (e.g. who this is for)"}},"required":["balanceSats","issueType"]},"RedeemGiftCardDto":{"type":"object","properties":{}},"CreateWithdrawalDto":{"type":"object","properties":{}},"CreatePaymentLinkDto":{"type":"object","properties":{"description":{"type":"string","description":"Payment link description","examples":["Premium Subscription - Monthly"]},"type":{"type":"string","description":"Payment type","enum":["fixed","flexible"],"examples":["fixed"]},"amount":{"type":"number","description":"Fixed amount in satoshis (required if type is fixed)","examples":[5000]},"minAmount":{"type":"number","description":"Minimum amount in satoshis (if type is flexible)","examples":[100]},"maxAmount":{"type":"number","description":"Maximum amount in satoshis (if type is flexible)","examples":[1000000]},"collectEmail":{"type":"boolean","description":"Collect customer email","default":false,"examples":[false]},"collectName":{"type":"boolean","description":"Collect customer name","default":false,"examples":[false]},"expiresAt":{"type":"string","description":"Expiration date (ISO 8601)","examples":["2025-12-31T23:59:59Z"]},"projectId":{"type":"string","description":"Associated project ID (optional for quick links)","examples":["uuid-of-project"]},"providerId":{"type":"string","description":"Provider ID to use for payments (optional - falls back to default/platform)","examples":["uuid-of-provider"]},"isQuickLink":{"type":"boolean","description":"Whether this is a quick link (personal use, no project)","default":false,"examples":[false]},"commentChars":{"type":"number","description":"Allow comments on the payment page (max comment chars)","examples":[100]}},"required":["description","type","collectEmail","collectName"]},"LinkWalletDto":{"type":"object","properties":{"nwcConnectionId":{"type":["string","null"],"description":"NWC connection id (your own wallet) to receive payments on. Null clears it.","examples":["b7e901ca-fc45-43fa-bdf8-bd59db919dd7"]},"accountWalletId":{"type":["string","null"],"description":"Specific account wallet id to receive payments. Null clears it.","examples":["f07ea461-7721-4115-8a5e-1ca4466f6463"]}}},"ClaimAddressDto":{"type":"object","properties":{}},"UpdateClaimedAddressDto":{"type":"object","properties":{}},"ApplyProviderDto":{"type":"object","properties":{"name":{"type":"string","examples":["NostrFeed"]},"baseUrl":{"type":"string","description":"LNbits base URL (no trailing slash)","examples":["https://ln.nostrfeed.com"]},"invoiceKey":{"type":"string","description":"Read-only LNbits invoice key (X-Api-Key) from any wallet on the instance — used only for the domain catalog, can never spend"},"contactEmail":{"type":"string","description":"Contact shown to buyers for refunds/renewals","examples":["support@nostrfeed.com"]},"logoUrl":{"type":"string","examples":["https://nostrfeed.com/logo.png"]}},"required":["name","baseUrl","invoiceKey"]},"RegisterProviderDto":{"type":"object","properties":{"name":{"type":"string","examples":["NostrFeed"]},"logoUrl":{"type":"string","examples":["https://nostrfeed.com/logo.png"]},"baseUrl":{"type":"string","description":"LNbits base URL (no trailing slash)","examples":["https://ln.nostrfeed.com"]},"invoiceKey":{"type":"string","description":"Read-only LNbits invoice key (X-Api-Key) — catalog import only, cannot spend"}},"required":["name","baseUrl","invoiceKey"]},"UpdateProviderDto":{"type":"object","properties":{"name":{"type":"string"},"logoUrl":{"type":"string"},"status":{"type":"string","enum":["active","paused"]},"commissionPct":{"type":"number","description":"Marketplace commission percent (default 0)"},"invoiceKey":{"type":"string","description":"Rotate the read-only invoice key"},"contactEmail":{"type":"string","description":"Provider contact (refunds/renewals)"}}},"RejectProviderDto":{"type":"object","properties":{"reason":{"type":"string","examples":["Domain does not resolve nostr.json"]}},"required":["reason"]},"CreateMarketplaceOrderDto":{"type":"object","properties":{"providerId":{"type":"string","description":"AddressProvider id"},"domainCatalogId":{"type":"string","description":"MarketplaceDomain catalog row id"},"localPart":{"type":"string","examples":["alice"]},"years":{"type":"number","examples":[1]},"expectedPriceSats":{"type":"number","description":"Sats quote shown at search time — re-quote guard (§2.2): reservation drift >5% requires re-confirmation"},"acceptRequote":{"type":"boolean","description":"Set true to accept the re-quoted price after a drift warning"},"pubkey":{"type":"string","description":"Nostr pubkey (hex) for the address; defaults to the wallet pubkey"},"promoCode":{"type":"string","description":"Promo code (provider-side)"}},"required":["providerId","domainCatalogId","localPart"]},"PublishVerificationDto":{"type":"object","properties":{"relays":{"description":"Relays to publish to (defaults to the wallet-generated identity relays)","type":"array","items":{"type":"string"}}}},"SubmitAppDto":{"type":"object","properties":{"name":{"type":"string","examples":["ZapStream"]},"description":{"type":"string","examples":["Live stream and zap in real time"]},"url":{"type":"string","examples":["https://zap.stream"]},"iconUrl":{"type":"string"},"category":{"type":"string","enum":["wallet","social","tools","games","media","commerce","developer","other"],"examples":["media"]},"tags":{"type":"array","items":{"type":"string"},"examples":[["streaming","zaps"]]},"lnAddress":{"type":"string","description":"Zap target lightning address. Omit to auto-provision app-{slug}@zapapi.app on our engine (zaps land in your ZapAPI wallet).","examples":["tips@zap.stream"]},"nostrPubkey":{"type":"string","description":"Owner nostr pubkey (hex) — shown on the card"}},"required":["name","description","url","category"]},"UpdateAppDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"url":{"type":"string","description":"Changing the URL re-triggers review"},"iconUrl":{"type":"string"},"category":{"type":"string","enum":["wallet","social","tools","games","media","commerce","developer","other"]},"tags":{"type":"array","items":{"type":"string"}}}},"BoostAppDto":{"type":"object","properties":{"product":{"type":"string","enum":["1k-3d","5k-7d","20k-14d"],"examples":["5k-7d"]},"walletId":{"type":"string","description":"Pay from a specific account wallet (default = default wallet)"},"payNow":{"type":"boolean","description":"Pay immediately from my ZapAPI wallet after invoicing","default":false}},"required":["product"]},"RejectAppDto":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"]},"CreateTopupDto":{"type":"object","properties":{"amountSats":{"type":"number","description":"Sats to top up. The Lightning invoice is created for exactly this amount; on payment the balance is credited amount + bonus (default +5%).","minimum":100,"maximum":10000000,"examples":[5000]}},"required":["amountSats"]},"SaveAutoTopupDto":{"type":"object","properties":{"nwcConnectionId":{"type":"string","description":"NWC connection id to pay auto-topups from"},"thresholdSats":{"type":"number","description":"Trigger auto-topup when balance falls below (sats)","examples":[500]},"topupSats":{"type":"number","description":"Amount to top up per trigger (sats)","examples":[5000]},"dailyCapSats":{"type":"number","description":"Max auto-topup spend per UTC day (sats)","examples":[20000]}},"required":["nwcConnectionId","thresholdSats","topupSats","dailyCapSats"]},"QuoteToolDto":{"type":"object","properties":{}},"ExecuteToolDto":{"type":"object","properties":{}},"DeleteBlobDto":{"type":"object","properties":{"url":{"type":"string","examples":["https://yjsm6thumlqlykuv.public.blob.vercel-storage.com/avatars/x.png"]}},"required":["url"]}}}},"proxyUrl":"$undefined"},"document":"/vercel/path0/server/src/api-docs/openapi.json","operations":[{"method":"get","path":"/api/v1/bio/profiles","tags":["bio-links"]}],"showDescription":true}]}]]}]

Public bio-profile directory — boosted first, then newest

Query ParametersCopy Anchor Link

Header ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Query Parameters

Header Parameters

Response Body