{"openapi":"3.1.0","info":{"title":"satsgate","version":"0.20.4"},"paths":{"/v1/rates":{"get":{"summary":"V1 Rates","description":"Effective BTC/USD quote. It does not name where the number came from.","operationId":"v1_rates_v1_rates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Get"}}}}}}},"/.well-known/satsgate.json":{"get":{"summary":"Well Known Satsgate","description":"Machine-readable manifest for discovery (agents/frameworks).\n\nNote: this does not replace OpenAPI; it complements it with pricing, auth, and links.","operationId":"well_known_satsgate_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Well Known Satsgate Get"}}}}}}},"/v1/plans":{"get":{"summary":"V1 Plans","operationId":"v1_plans_v1_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Plans V1 Plans Get"}}}}}}},"/v1/balance":{"get":{"summary":"V1 Balance","operationId":"v1_balance_v1_balance_get","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/client":{"get":{"summary":"V1 Client","operationId":"v1_client_v1_client_get","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ledger":{"get":{"summary":"V1 Ledger","description":"Return this client's verification ledger entries (credits).","operationId":"v1_ledger_v1_ledger_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"before_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Before Id"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usage/summary":{"get":{"summary":"V1 Usage Summary","description":"Usage summary over a time window (default: last 24h).","operationId":"v1_usage_summary_v1_usage_summary_get","parameters":[{"name":"since_hours","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Since Hours"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usage/daily":{"get":{"summary":"V1 Usage Daily","description":"Daily (UTC) series for charts and automated top-ups.","operationId":"v1_usage_daily_v1_usage_daily_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usage/forecast":{"get":{"summary":"V1 Usage Forecast","description":"Pace of recent paid unlocks, in millisatoshis. Never names a pack.","operationId":"v1_usage_forecast_v1_usage_forecast_get","parameters":[{"name":"lookback_hours","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Lookback Hours"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/client/payee":{"post":{"summary":"V1 Client Set Payee","operationId":"v1_client_set_payee_v1_client_payee_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientPayeeIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/client/payee/evm/challenge":{"post":{"summary":"V1 Client Evm Challenge","description":"Ask for an EIP-191 message. Nothing is written on chain and the stored address does not change.","operationId":"v1_client_evm_challenge_v1_client_payee_evm_challenge_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvmPayeeChallengeIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/client/payee/evm":{"post":{"summary":"V1 Client Evm Payee","description":"Verify the signed message and save one EVM payTo. A bad signature does not change the stored address.","operationId":"v1_client_evm_payee_v1_client_payee_evm_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/client/payee/evm/connect":{"post":{"summary":"V1 Client Evm Connect","description":"Mint a one-time browser link. The account key is not sent to the page.","operationId":"v1_client_evm_connect_v1_client_payee_evm_connect_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connect/evm":{"get":{"summary":"V1 Connect Evm","description":"What the page may show before the wallet connects. No API key.","operationId":"v1_connect_evm_v1_connect_evm_get","parameters":[{"name":"X-Connect-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Connect-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connect/evm/challenge":{"post":{"summary":"V1 Connect Evm Challenge","description":"Same challenge as the account-key route. A bad token does not start one.","operationId":"v1_connect_evm_challenge_v1_connect_evm_challenge_post","parameters":[{"name":"X-Connect-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Connect-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvmPayeeChallengeIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connect/evm/verify":{"post":{"summary":"V1 Connect Evm Verify","description":"Verify the signature. Success clears the connect token. Failure leaves it in place.\n\nThe body is parsed here so a long signature is not echoed in a 422. A contract\nsignature is checked on Base outside the event loop.","operationId":"v1_connect_evm_verify_v1_connect_evm_verify_post","parameters":[{"name":"X-Connect-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Connect-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/client/alert-email":{"put":{"summary":"V1 Client Alert Email Put","description":"Set or replace the pending alert address. The account key is required.","operationId":"v1_client_alert_email_put_v1_client_alert_email_put","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"V1 Client Alert Email Delete","description":"Remove the confirmed address and any pending one. The account key is required.","operationId":"v1_client_alert_email_delete_v1_client_alert_email_delete","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/client/api-key/rotate":{"post":{"summary":"V1 Client Api Key Rotate","description":"Replace the account key now. Empty body. Only the current account key in X-Api-Key.\n\nX-Connect-Token, an sgc_ session, a restricted sgr_ key, and X-Admin-Token are not accepted.\nThe old key stops working as soon as this commits. There is no grace period.\n200 returns ``api_key`` (shown once) and ``prefix`` (the first 8 characters).\nA restricted key is 403 insufficient_scope. A lost race is 401 invalid_api_key.\nShares the account security limit (``SATSGATE_RL_MAX_SECURITY`` per\n``SATSGATE_RL_WINDOW_SECONDS``, keyed by client id) with webhook writes.","operationId":"v1_client_api_key_rotate_v1_client_api_key_rotate_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/client/webhook":{"put":{"summary":"V1 Client Webhook Put","description":"Create or replace the security webhook. Account key only.\n\n200 is ``ok``, ``url``, and ``enabled``. ``secret`` (``whsec_…``) is present\nonly on the first create or when ``rotate_secret`` is true. Replacing only\nthe URL keeps the secret and omits it. 503 ``webhooks_unavailable`` when\n``SATSGATE_SITE_SECRET_KEY`` is unset. ``SATSGATE_WEBHOOKS=0`` stops the\nsender thread and does not block this call. The URL is not echoed in errors.","operationId":"v1_client_webhook_put_v1_client_webhook_put","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"additionalProperties":false,"properties":{"url":{"type":"string","maxLength":300,"description":"https URL with no username or password. Public addresses only."},"rotate_secret":{"type":"boolean","description":"When true, replace the whsec_ signing secret and return it once."}}}}}}},"get":{"summary":"V1 Client Webhook Get","description":"Read the webhook. Account key only. Never returns the signing secret.\n\n``secret_prefix`` is the start of the ``whsec_`` value. ``last_delivery`` is\n``{\"status\", \"at\"}`` or null. No webhook is ``url: null`` and ``enabled: false``.","operationId":"v1_client_webhook_get_v1_client_webhook_get","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"V1 Client Webhook Delete","description":"Remove the webhook and drop deliveries that have not been posted. Account key only.","operationId":"v1_client_webhook_delete_v1_client_webhook_delete","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/client/webhook/test":{"post":{"summary":"V1 Client Webhook Test","description":"Queue a webhook_test event. Account key only.\n\n404 ``webhook_not_configured`` when none is saved. 409 ``webhook_disabled`` when\na 404 or 410 turned it off. 503 ``webhooks_unavailable`` when the encryption\nkey is unset. Shares the account security limit with rotation and webhook\nwrites (``SATSGATE_RL_MAX_SECURITY`` calls per window, keyed by client id).","operationId":"v1_client_webhook_test_v1_client_webhook_test_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connect/alert-email":{"post":{"summary":"V1 Connect Alert Email","description":"First alert address only. A confirmed address has to be changed with the account key.\n\nThis does not consume the connect token.","operationId":"v1_connect_alert_email_v1_connect_alert_email_post","parameters":[{"name":"X-Connect-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Connect-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"V1 Connect Alert Email Preview","description":"What the confirmation screen may show. The token is not consumed.","operationId":"v1_connect_alert_email_preview_v1_connect_alert_email_get","parameters":[{"name":"X-Email-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Email-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connect/alert-email/confirm":{"post":{"summary":"V1 Connect Alert Email Confirm","description":"Confirm on a POST. A mail scanner that only fetches the link does not confirm it.","operationId":"v1_connect_alert_email_confirm_v1_connect_alert_email_confirm_post","parameters":[{"name":"X-Email-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Email-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys":{"post":{"summary":"V1 Api Keys Create","description":"Create a restricted key. The account key is required. The secret is returned once.","operationId":"v1_api_keys_create_v1_api_keys_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreateIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"V1 Api Keys List","description":"List this client's restricted keys. Secrets are never included.","operationId":"v1_api_keys_list_v1_api_keys_get","parameters":[{"name":"include_revoked","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Revoked"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys/{key_id}/revoke":{"post":{"summary":"V1 Api Keys Revoke","description":"Revoke a restricted key. Repeating this call stays revoked.","operationId":"v1_api_keys_revoke_v1_api_keys__key_id__revoke_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sites":{"get":{"summary":"V1 Sites Public","description":"Approved sites that opted in. No owner, origin, or secret.","operationId":"v1_sites_public_v1_sites_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"V1 Sites Create","description":"Register a site. The origin HMAC secret is returned once. New sites start pending.","operationId":"v1_sites_create_v1_sites_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteCreateIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sites/mine":{"get":{"summary":"V1 Sites Mine","operationId":"v1_sites_mine_v1_sites_mine_get","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sites/{slug}":{"get":{"summary":"V1 Sites Get","operationId":"v1_sites_get_v1_sites__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"summary":"V1 Sites Update","operationId":"v1_sites_update_v1_sites__slug__patch","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteUpdateIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"V1 Sites Delete","operationId":"v1_sites_delete_v1_sites__slug__delete","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sites/{slug}/rotate-secret":{"post":{"summary":"V1 Sites Rotate Secret","operationId":"v1_sites_rotate_secret_v1_sites__slug__rotate_secret_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sites/{slug}/verify-origin":{"post":{"summary":"V1 Sites Verify Origin","description":"Ask the origin to prove the receipt checker is installed. Any site status is accepted.","operationId":"v1_sites_verify_origin_v1_sites__slug__verify_origin_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sites/{slug}/routes":{"post":{"summary":"V1 Site Routes Create","operationId":"v1_site_routes_create_v1_sites__slug__routes_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteCreateIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sites/{slug}/routes/{route_id}":{"patch":{"summary":"V1 Site Routes Update","operationId":"v1_site_routes_update_v1_sites__slug__routes__route_id__patch","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"route_id","in":"path","required":true,"schema":{"type":"integer","title":"Route Id"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteUpdateIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"V1 Site Routes Delete","operationId":"v1_site_routes_delete_v1_sites__slug__routes__route_id__delete","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"route_id","in":"path","required":true,"schema":{"type":"integer","title":"Route Id"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/topup/status/{payment_hash}":{"get":{"summary":"V1 Topup Status","description":"Poll a top-up that was paid from any wallet.\n\nAuthorization is `L402 <macaroon>` (no preimage) or the usual preimage form.\nSettlement is read from the verify URL stored when the invoice was created.\nThe API key is returned only on the call that creates the account.","operationId":"v1_topup_status_v1_topup_status__payment_hash__get","parameters":[{"name":"payment_hash","in":"path","required":true,"schema":{"type":"string","title":"Payment Hash"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accounts":{"post":{"summary":"V1 Accounts","description":"Open an account. The sg_ key is returned once. No invoice and no personal data.","operationId":"v1_accounts_v1_accounts_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SignupIn"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/topup/usdc":{"post":{"summary":"V1 Topup Usdc","description":"Authenticated free-amount USDC top-up. A missing accounting rate is 503, not a 402.","operationId":"v1_topup_usdc_v1_topup_usdc_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment-Signature"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsdcTopupIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/topup/lightning":{"post":{"summary":"V1 Topup Lightning","description":"Top up any amount of sats. Minimum is SATSGATE_TOPUP_MIN_SATS.\n\nNo key: the invoice can create the account when it is paid. A restricted\nkey cannot top up. The credited millisatoshis include the per-top-up bonus.","operationId":"v1_topup_lightning_v1_topup_lightning_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LightningTopupIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/topup/{plan_id}/x402":{"get":{"summary":"V1 Topup X402","description":"Buy a credit pack with USDC.\n\nWhile the operator CDP switch is on, the only network is Base\n(`eip155:8453`) through the CDP facilitator. While it is off, the only\nnetwork is Base Sepolia (`eip155:84532`). Credits are not sold for testnet\nUSDC once mainnet is on. No `PAYMENT-SIGNATURE`: 402 and `PAYMENT-REQUIRED`\n(scheme `exact`, payTo the treasury, amount from the locked BTC/USD quote).\nWith that header: verify, settle, then grant credits. A failed settle grants\nnothing. Credits are not redeemable for USDC. Lightning top-up is separate.","operationId":"v1_topup_x402_v1_topup__plan_id__x402_get","parameters":[{"name":"plan_id","in":"path","required":true,"schema":{"type":"string","title":"Plan Id"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/topup/{plan_id}":{"get":{"summary":"V1 Topup","description":"Buy prepaid payment verifications (credits) by plan.\n\n- No Authorization: 402 + invoice + macaroon\n- `Authorization: L402 <macaroon>:<preimage>`: credit the account\n- `Authorization: L402 <macaroon>`: credit the account when the provider's\n  stored LUD-21 verify URL reports the invoice settled\n\nThe preimage flow keeps working for providers that do not advertise verify.","operationId":"v1_topup_v1_topup__plan_id__get","parameters":[{"name":"plan_id","in":"path","required":true,"schema":{"type":"string","title":"Plan Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/paywall/challenge":{"post":{"summary":"V1 Paywall Challenge","description":"Generate an L402 challenge for a resource.\n\nHow to use it:\n- Your backend (customer) calls this endpoint and receives invoice + macaroon.\n- Your backend returns HTTP 402 to *your* end user with those values.\n\n`invoice_expires_at` is when the invoice stops being payable. `claim_until`\n(also returned as `valid_until`) is when satsgate will still unlock it.\nPassing `payee_lightning_address` on the first challenge saves it. Change\nthe saved payee with POST /v1/client/payee. A restricted key cannot save or\nchange the payee.\n\nA trusted proxy may send `X-Satsgate-Buyer-Ip` with the end buyer's address.\nThe header is ignored unless the TCP peer is in `SATSGATE_TRUSTED_PROXIES`.\nWithout it, limits stay per client, as before.","operationId":"v1_paywall_challenge_v1_paywall_challenge_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"X-Satsgate-Buyer-Ip","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Satsgate-Buyer-Ip"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaywallChallengeIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/paywall/verify":{"post":{"summary":"V1 Paywall Verify","description":"Verify an L402 Authorization and spend payment verifications (credits) (once per payment_hash).\n\nThis is the core of the \"plans + prepay\" model:\n- the customer tops up payment verifications (credits)\n- each verified payment consumes 1 verification (credit) (exactly once per payment_hash)\n\n`Authorization: L402 <macaroon>:<preimage>` is the original flow.\n`Authorization: L402 <macaroon>` settles from the stored LUD-21 verify URL when the\npayee's provider advertised one.\n\n`GET /v1/paywall/status/{payment_hash}` is the poll alternative. While the invoice\nis unpaid, this route returns HTTP 402 `payment_pending` and status returns HTTP 200\n`pending`. The first settled call on either route spends credits; a repeat spends 0.","operationId":"v1_paywall_verify_v1_paywall_verify_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaywallVerifyIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/paywall/status/{payment_hash}":{"get":{"summary":"V1 Paywall Status","description":"Poll a paywall challenge paid from any wallet.\n\nRequires the merchant API key and the macaroon issued for this payment hash.\nThis is an alternative to POST /v1/paywall/verify, not a free read. The first\nsettled call spends credits once for this payment_hash. A repeat, on either\nroute, spends 0. While the invoice is unpaid this route returns HTTP 200\n`status=pending` (verify returns HTTP 402 `payment_pending` for that same state).","operationId":"v1_paywall_status_v1_paywall_status__payment_hash__get","parameters":[{"name":"payment_hash","in":"path","required":true,"schema":{"type":"string","title":"Payment Hash"}},{"name":"expected_resource","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Expected Resource"}},{"name":"cost_credits","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"default":1,"title":"Cost Credits"}},{"name":"consume","in":"query","required":false,"schema":{"type":"boolean","description":"When true, atomically take one use of this payment. False checks without consuming.","default":false,"title":"Consume"},"description":"When true, atomically take one use of this payment. False checks without consuming."},{"name":"charge","in":"query","required":false,"schema":{"type":"boolean","description":"When false, confirm without debiting. The default still debits on the first settled call.","default":true,"title":"Charge"},"description":"When false, confirm without debiting. The default still debits on the first settled call."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/paywall/charge":{"post":{"summary":"V1 Paywall Charge","description":"Debit after the origin returned 2xx. A confirm call does not debit.\n\nOld clients omit this route. They keep sending charge=true on verify, which\nstill debits before they forward.","operationId":"v1_paywall_charge_v1_paywall_charge_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaywallChargeIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/paywall/x402/verify":{"post":{"summary":"V1 Paywall X402 Verify","description":"Check a PAYMENT-SIGNATURE. serve=true means the caller may call the origin. No credit moves.","operationId":"v1_paywall_x402_verify_v1_paywall_x402_verify_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaywallX402In"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/paywall/x402/settle":{"post":{"summary":"V1 Paywall X402 Settle","description":"Call only after the origin returned 2xx. The facilitator settles, then one credit is taken.","operationId":"v1_paywall_x402_settle_v1_paywall_x402_settle_post","parameters":[{"name":"X-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaywallX402In"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ApiKeyCreateIn":{"properties":{"label":{"type":"string","maxLength":64,"minLength":1,"title":"Label"},"scope":{"type":"string","maxLength":32,"title":"Scope","description":"paywall (default), sites:read, or sites:write. Omit it to keep a paywall key.","default":"paywall"},"resource_prefix":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Resource Prefix","description":"When set, this key can only challenge, check, and verify resources that start with this prefix. The comparison is case-sensitive. Omit it to allow any resource."}},"type":"object","required":["label"],"title":"ApiKeyCreateIn"},"ClientPayeeIn":{"properties":{"payee_lightning_address":{"type":"string","maxLength":200,"minLength":3,"title":"Payee Lightning Address"}},"type":"object","required":["payee_lightning_address"],"title":"ClientPayeeIn"},"EvmPayeeChallengeIn":{"properties":{"address":{"type":"string","maxLength":42,"minLength":42,"title":"Address"}},"type":"object","required":["address"],"title":"EvmPayeeChallengeIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LightningTopupIn":{"properties":{"sats":{"type":"integer","maximum":10000000.0,"minimum":1.0,"title":"Sats"}},"type":"object","required":["sats"],"title":"LightningTopupIn"},"PaywallChallengeIn":{"properties":{"payee_lightning_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payee Lightning Address","description":"Lightning Address that will receive the payment (user@domain). If omitted, the client's registered payee is used (see /v1/client/payee)."},"amount_sats":{"type":"integer","maximum":10000000.0,"minimum":1.0,"title":"Amount Sats"},"resource":{"type":"string","maxLength":200,"minLength":1,"title":"Resource"},"memo":{"anyOf":[{"type":"string","maxLength":250},{"type":"null"}],"title":"Memo"},"ttl_seconds":{"anyOf":[{"type":"integer","maximum":86400.0,"minimum":30.0},{"type":"null"}],"title":"Ttl Seconds","description":"Minimum seconds the Lightning invoice must stay payable. Does not shorten the macaroon. claim_until follows the invoice expiry plus grace, capped. Omit it to use SATSGATE_TOKEN_TTL_SECONDS as that minimum."},"max_uses":{"anyOf":[{"type":"integer","maximum":100000.0,"minimum":1.0},{"type":"null"}],"title":"Max Uses","description":"How many consume=true calls this payment covers. Omit it, and omit access_seconds, to keep the previous unlimited re-verify behaviour."},"access_seconds":{"anyOf":[{"type":"integer","maximum":604800.0,"minimum":1.0},{"type":"null"}],"title":"Access Seconds","description":"Seconds of access starting when the payment first settles. The server caps this (SATSGATE_PAYWALL_ACCESS_CAP_SECONDS, default 7 days). A max_uses bundle that omits this still ends at that cap."},"x402":{"type":"boolean","title":"X402","description":"Also attach an x402 USDC offer for resource_url. Requires a verified EVM payee. Lightning is still issued.","default":false},"resource_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Resource Url","description":"Public http(s) URL the buyer will pay. Required when x402 is true."},"x402_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X402 Mode","description":"test or live. Omitted with x402 true means test (Base Sepolia). live offers only Base and requires the operator CDP switch. The two networks are never in the same 402."}},"type":"object","required":["amount_sats","resource"],"title":"PaywallChallengeIn"},"PaywallChargeIn":{"properties":{"expected_resource":{"type":"string","maxLength":200,"minLength":1,"title":"Expected Resource"},"payment_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Payment Hash"},"cost_credits":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Cost Credits","default":1}},"type":"object","required":["expected_resource","payment_hash"],"title":"PaywallChargeIn"},"PaywallVerifyIn":{"properties":{"expected_resource":{"type":"string","maxLength":200,"minLength":1,"title":"Expected Resource","description":"Must exactly match the resource from POST /v1/paywall/challenge. The comparison is case-sensitive."},"cost_credits":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Cost Credits","default":1},"consume":{"type":"boolean","title":"Consume","description":"When true, atomically take one use of this payment. Required to enforce max_uses or access_seconds. False leaves the counter unchanged and still settles a first unlock.","default":false},"charge":{"type":"boolean","title":"Charge","description":"When true, debit on this call, which is what proxy 0.8.0 does before it forwards. When false, confirm the payment and leave the credit. POST /v1/paywall/charge debits after the origin returns 2xx.","default":true}},"type":"object","required":["expected_resource"],"title":"PaywallVerifyIn"},"PaywallX402In":{"properties":{"resource":{"type":"string","maxLength":200,"minLength":1,"title":"Resource"},"resource_url":{"type":"string","maxLength":500,"minLength":8,"title":"Resource Url"},"payment_signature":{"type":"string","maxLength":12000,"minLength":1,"title":"Payment Signature"}},"type":"object","required":["resource","resource_url","payment_signature"],"title":"PaywallX402In"},"RouteCreateIn":{"properties":{"path":{"type":"string","maxLength":200,"minLength":1,"title":"Path"},"price_sats":{"anyOf":[{"type":"integer","maximum":10000000.0,"minimum":1.0},{"type":"null"}],"title":"Price Sats"},"price_currency":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Price Currency"},"price_usd_atomic":{"anyOf":[{"type":"integer","maximum":100000000.0,"minimum":1.0},{"type":"null"}],"title":"Price Usd Atomic"},"max_uses":{"anyOf":[{"type":"integer","maximum":100000.0,"minimum":1.0},{"type":"null"}],"title":"Max Uses"},"access_seconds":{"anyOf":[{"type":"integer","maximum":604800.0,"minimum":1.0},{"type":"null"}],"title":"Access Seconds"}},"type":"object","required":["path"],"title":"RouteCreateIn"},"RouteUpdateIn":{"properties":{"path":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Path"},"price_sats":{"anyOf":[{"type":"integer","maximum":10000000.0,"minimum":1.0},{"type":"null"}],"title":"Price Sats"},"price_currency":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Price Currency"},"price_usd_atomic":{"anyOf":[{"type":"integer","maximum":100000000.0,"minimum":1.0},{"type":"null"}],"title":"Price Usd Atomic"},"max_uses":{"anyOf":[{"type":"integer","maximum":100000.0,"minimum":1.0},{"type":"null"}],"title":"Max Uses"},"access_seconds":{"anyOf":[{"type":"integer","maximum":604800.0,"minimum":1.0},{"type":"null"}],"title":"Access Seconds"}},"type":"object","title":"RouteUpdateIn"},"SignupIn":{"properties":{},"additionalProperties":false,"type":"object","title":"SignupIn","description":"Empty object only. Personal data is refused."},"SiteCreateIn":{"properties":{"slug":{"type":"string","maxLength":40,"minLength":3,"title":"Slug"},"display_name":{"type":"string","maxLength":80,"minLength":1,"title":"Display Name"},"description":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Description"},"origin_url":{"type":"string","maxLength":300,"minLength":8,"title":"Origin Url"},"listed":{"type":"boolean","title":"Listed","default":false},"accept_terms":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Accept Terms"}},"type":"object","required":["slug","display_name","origin_url"],"title":"SiteCreateIn"},"SiteUpdateIn":{"properties":{"display_name":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Display Name"},"description":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Description"},"origin_url":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Origin Url"},"listed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Listed"},"rail_lightning":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Rail Lightning"},"rail_x402":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Rail X402"},"x402_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X402 Mode","description":"Exclusive USDC mode. test offers only Base Sepolia. live offers only Base and requires the operator CDP switch. A new site leaves this unset. Turning x402 on without a mode stores test."},"accept_terms":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Accept Terms"}},"type":"object","title":"SiteUpdateIn"},"UsdcTopupIn":{"properties":{"usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Usd"},"usd_atomic":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Usd Atomic"}},"additionalProperties":false,"type":"object","title":"UsdcTopupIn"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}