{"openapi":"3.1.0","info":{"title":"Aurelio Platform API","version":"1.0.0","description":"The MyAurelio platform API for SaaS checkout, tenant discovery, Medusa admin extensions, merchant online-store settings, provisioning, domains, billing, and webhooks.","contact":{"name":"Aurelio","url":"https://admin.myaurelio.com/app"}},"servers":[{"url":"https://merger-fabrics-disclose-exact.trycloudflare.com","description":"Aurelio API"}],"tags":[{"name":"System","description":"Health, docs, and OpenAPI metadata."},{"name":"Storefront config","description":"Public storefront content and theme data."},{"name":"SaaS checkout","description":"Plans, slug availability, Stripe checkout, and checkout status."},{"name":"Tenants","description":"Resolve myaurelio.com subdomains to live tenant details."},{"name":"Merchant admin","description":"Customer-facing Online Store settings inside Medusa Admin."},{"name":"Superadmin","description":"Aurelio operator controls for stores, plans, billing, deployments, and alerts."},{"name":"Provisioning","description":"Deployment callbacks and provisioning status."},{"name":"Webhooks","description":"Stripe and provisioner webhook receivers."}],"paths":{"/":{"get":{"tags":["System"],"summary":"Open Scalar API reference","responses":{"200":{"description":"Scalar API Reference HTML.","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/health":{"get":{"tags":["System"],"summary":"Health check","responses":{"200":{"description":"The API is healthy.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/docs":{"get":{"tags":["System"],"summary":"Scalar API reference","responses":{"200":{"description":"Scalar API Reference HTML.","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/scalar":{"get":{"tags":["System"],"summary":"Scalar API reference alias","responses":{"200":{"description":"Scalar API Reference HTML.","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/openapi":{"get":{"tags":["System"],"summary":"OpenAPI document","responses":{"200":{"description":"OpenAPI document.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/openapi.json":{"get":{"tags":["System"],"summary":"OpenAPI document alias","responses":{"200":{"description":"OpenAPI document.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/store/aurelio/config":{"get":{"tags":["Storefront config"],"summary":"Get full public Aurelio storefront config","responses":{"200":{"description":"Store profile, theme, SEO defaults, and homepage sections.","content":{"application/json":{"schema":{"type":"object","properties":{"store_profile":{"$ref":"#/components/schemas/StoreProfile"},"theme":{"$ref":"#/components/schemas/Theme"},"seo_defaults":{"$ref":"#/components/schemas/SeoDefaults"},"homepage_sections":{"type":"array","items":{"$ref":"#/components/schemas/HomepageSection"}}}}}}}}}},"/store/aurelio/homepage":{"get":{"tags":["Storefront config"],"summary":"Get homepage sections","responses":{"200":{"description":"Public homepage sections.","content":{"application/json":{"schema":{"type":"object","properties":{"homepage_sections":{"type":"array","items":{"$ref":"#/components/schemas/HomepageSection"}}}}}}}}}},"/store/aurelio/seo":{"get":{"tags":["Storefront config"],"summary":"Get SEO defaults","responses":{"200":{"description":"SEO defaults.","content":{"application/json":{"schema":{"type":"object","properties":{"seo_defaults":{"$ref":"#/components/schemas/SeoDefaults"}}}}}}}}},"/store/aurelio/puck-pages/{page_key}":{"get":{"tags":["Storefront config"],"summary":"Get public Puck page content","parameters":[{"name":"page_key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Puck page data.","content":{"application/json":{"schema":{"type":"object","properties":{"page":{"$ref":"#/components/schemas/PuckPage"}}}}}},"404":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/store/aurelio/saas/plans":{"get":{"tags":["SaaS checkout"],"summary":"List active SaaS plans","responses":{"200":{"description":"Available Aurelio SaaS plans.","content":{"application/json":{"schema":{"type":"object","properties":{"plans":{"type":"array","items":{"$ref":"#/components/schemas/SaasPlan"}}}}}}}}}},"/store/aurelio/saas/availability":{"get":{"tags":["SaaS checkout"],"summary":"Check whether a myaurelio.com store subdomain is available","description":"Reserved platform names like admin, api, and www are always unavailable because they belong to Aurelio itself.","parameters":[{"name":"slug","in":"query","schema":{"type":"string","example":"atelier-demo"}},{"name":"store_name","in":"query","schema":{"type":"string","example":"Atelier Demo"}}],"responses":{"200":{"description":"Availability result.","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","example":"atelier-demo"},"available":{"type":"boolean","example":true},"reason":{"type":"string","nullable":true,"example":"reserved_platform_subdomain"}}}}}},"400":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/store/aurelio/saas/checkout":{"post":{"tags":["SaaS checkout"],"summary":"Create a Stripe Checkout session for a new tenant","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSaasCheckout"}}}},"responses":{"200":{"description":"Checkout result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaasCheckoutResult"}}}},"400":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/store/aurelio/saas/checkout-sessions/{id}":{"get":{"tags":["SaaS checkout"],"summary":"Get checkout session status","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Checkout session status.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/store/aurelio/saas/checkouts/{id}":{"get":{"tags":["SaaS checkout"],"summary":"Get checkout status alias","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Checkout status.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/store/aurelio/saas/stores/{slug}":{"get":{"tags":["SaaS checkout"],"summary":"Get public SaaS store status","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public SaaS store.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSaasStoreEnvelope"}}}},"404":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/store/aurelio/tenant/resolve":{"get":{"tags":["Tenants"],"summary":"Resolve tenant by host or slug","description":"Use this from the shared storefront on *.myaurelio.com. Reserved hosts such as admin.myaurelio.com and api.myaurelio.com are never returned as tenants.","parameters":[{"name":"host","in":"query","schema":{"type":"string","example":"demo.myaurelio.com"}},{"name":"slug","in":"query","schema":{"type":"string","example":"demo"}}],"responses":{"200":{"description":"Tenant was found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantResolveResult"}}}},"400":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/admin/aurelio/merchant/context":{"get":{"tags":["Merchant admin"],"summary":"Get merchant online-store context","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"responses":{"200":{"description":"Merchant context.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/admin/aurelio/merchant/billing":{"get":{"tags":["Merchant admin"],"summary":"Get merchant billing status","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"responses":{"200":{"description":"Billing status.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Merchant admin"],"summary":"Create merchant Stripe billing portal link","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingPortalRequest"}}}},"responses":{"200":{"description":"Billing portal URL.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/admin/aurelio/merchant/domains":{"get":{"tags":["Merchant admin"],"summary":"List merchant domains","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"responses":{"200":{"description":"Merchant domains.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Merchant admin"],"summary":"Request a merchant custom domain","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantDomainRequest"}}}},"responses":{"200":{"description":"Domain request.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/admin/aurelio/merchant/domains/{domain_id}/verify":{"post":{"tags":["Merchant admin"],"summary":"Verify merchant domain","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"domain_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantDomainVerification"}}}},"responses":{"200":{"description":"Verification status.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/admin/aurelio/homepage-sections":{"get":{"tags":["Merchant admin"],"summary":"List homepage sections","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"responses":{"200":{"description":"Homepage sections.","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"tags":["Merchant admin"],"summary":"Create homepage section","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HomepageSectionInput"}}}},"responses":{"200":{"description":"Created section.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/homepage-sections/{id}":{"post":{"tags":["Merchant admin"],"summary":"Update homepage section","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HomepageSectionInput"}}}},"responses":{"200":{"description":"Updated section.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Merchant admin"],"summary":"Delete homepage section","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted section.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/admin/aurelio/homepage-sections/reorder":{"post":{"tags":["Merchant admin"],"summary":"Reorder homepage sections","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HomepageReorder"}}}},"responses":{"200":{"description":"Reordered sections.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/onboarding":{"get":{"tags":["Merchant admin"],"summary":"Get onboarding state","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"responses":{"200":{"description":"Onboarding state.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/onboarding/complete-step":{"post":{"tags":["Merchant admin"],"summary":"Complete an onboarding step","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["step"],"properties":{"step":{"type":"string","example":"domain"}}}}}},"responses":{"200":{"description":"Updated onboarding state.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/puck-pages/{page_key}":{"get":{"tags":["Merchant admin"],"summary":"Get editable Puck page","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"page_key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Puck page.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Merchant admin"],"summary":"Save editable Puck page","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"page_key","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PuckPage"}}}},"responses":{"200":{"description":"Saved Puck page.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/admin/aurelio/saas/health":{"get":{"tags":["Superadmin"],"summary":"Get SaaS platform health summary","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"responses":{"200":{"description":"Health summary.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/plans":{"get":{"tags":["Superadmin"],"summary":"List SaaS plans","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"responses":{"200":{"description":"Plans.","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"tags":["Superadmin"],"summary":"Create or update SaaS plan","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaasPlanInput"}}}},"responses":{"200":{"description":"Saved plan.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores":{"get":{"tags":["Superadmin"],"summary":"List SaaS stores","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"responses":{"200":{"description":"Stores with latest deployment status.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores/{id}":{"get":{"tags":["Superadmin"],"summary":"Get SaaS store detail","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Store detail.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Superadmin"],"summary":"Update SaaS store status","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaasStoreStatusUpdate"}}}},"responses":{"200":{"description":"Updated store.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/admin/aurelio/saas/stores/{id}/audit-logs":{"get":{"tags":["Superadmin"],"summary":"List SaaS store audit logs","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Audit logs.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores/{id}/billing-portal":{"post":{"tags":["Superadmin"],"summary":"Create billing portal for a tenant","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingPortalRequest"}}}},"responses":{"200":{"description":"Billing portal.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores/{id}/change-plan":{"post":{"tags":["Superadmin"],"summary":"Create billing portal flow to change tenant plan","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanChangeRequest"}}}},"responses":{"200":{"description":"Plan change flow.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores/{id}/deploy":{"post":{"tags":["Provisioning"],"summary":"Deploy tenant backend/admin","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantDeploymentRequest"}}}},"responses":{"200":{"description":"Deployment result.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores/{id}/redeploy":{"post":{"tags":["Provisioning"],"summary":"Redeploy tenant backend/admin","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantDeploymentRequest"}}}},"responses":{"200":{"description":"Redeployment result.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores/{id}/suspend":{"post":{"tags":["Provisioning"],"summary":"Suspend tenant","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantDeploymentRequest"}}}},"responses":{"200":{"description":"Suspension result.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores/{id}/cancel":{"post":{"tags":["Provisioning"],"summary":"Cancel tenant","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantDeploymentRequest"}}}},"responses":{"200":{"description":"Cancellation result.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores/{id}/domains":{"get":{"tags":["Superadmin"],"summary":"List tenant domains","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Tenant domains.","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"tags":["Superadmin"],"summary":"Add tenant custom domain","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantDomainRequest"}}}},"responses":{"200":{"description":"Tenant domain.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores/{id}/domains/{domain_id}/verify":{"post":{"tags":["Superadmin"],"summary":"Verify tenant custom domain","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"domain_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantDomainVerification"}}}},"responses":{"200":{"description":"Verification result.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores/{id}/usage-limits":{"get":{"tags":["Superadmin"],"summary":"Get tenant usage limits","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Usage limits.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/saas/stores/{id}/usage-limits/check":{"post":{"tags":["Superadmin"],"summary":"Check a tenant usage limit","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageLimitCheck"}}}},"responses":{"200":{"description":"Usage limit check.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/admin/aurelio/superadmin/alerts/{id}":{"post":{"tags":["Superadmin"],"summary":"Update superadmin alert status","security":[{"MedusaAdminSession":[]},{"MedusaBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuperadminAlertUpdate"}}}},"responses":{"200":{"description":"Updated alert.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/webhooks/aurelio/stripe":{"post":{"tags":["Webhooks"],"summary":"Stripe billing webhook","description":"Receives Stripe events such as checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, and customer.subscription.deleted.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Webhook accepted.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webhooks/aurelio/provisioning":{"post":{"tags":["Webhooks"],"summary":"Tenant provisioner callback","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisioningResult"}}}},"responses":{"200":{"description":"Provisioning result recorded.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Aurelio API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webhooks/aurelio/provisioning/mock":{"post":{"tags":["Webhooks"],"summary":"Mock provisioner callback for development","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisioningResult"}}}},"responses":{"200":{"description":"Mock provisioning result.","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"securitySchemes":{"MedusaAdminSession":{"type":"apiKey","in":"cookie","name":"connect.sid","description":"Medusa Admin session cookie."},"MedusaBearer":{"type":"http","scheme":"bearer","description":"Medusa admin bearer token or API key."},"PublishableApiKey":{"type":"apiKey","in":"header","name":"x-publishable-api-key","description":"Medusa publishable API key for store routes when called directly."}},"schemas":{"ErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}},"StoreProfile":{"type":"object","properties":{"store_name":{"type":"string","example":"Aurelio Demo"},"legal_name":{"type":"string","nullable":true},"tagline":{"type":"string","nullable":true},"support_email":{"type":"string","format":"email"},"phone":{"type":"string","nullable":true},"whatsapp":{"type":"string","nullable":true},"logo_url":{"type":"string","nullable":true},"favicon_url":{"type":"string","nullable":true},"default_locale":{"type":"string","example":"en"},"default_currency_code":{"type":"string","example":"eur"}}},"Theme":{"type":"object","properties":{"primary_color":{"type":"string","example":"#111827"},"secondary_color":{"type":"string","example":"#6b7280"},"accent_color":{"type":"string","example":"#c9a86a"},"background_color":{"type":"string","example":"#ffffff"},"text_color":{"type":"string","example":"#111827"},"heading_font":{"type":"string","example":"Inter"},"body_font":{"type":"string","example":"Inter"},"border_radius":{"type":"string","example":"8px"},"button_style":{"type":"string","example":"solid"},"layout_style":{"type":"string","example":"editorial"}}},"SeoDefaults":{"type":"object","properties":{"meta_title":{"type":"string"},"meta_description":{"type":"string"},"og_image_url":{"type":"string","nullable":true},"twitter_image_url":{"type":"string","nullable":true},"robots":{"type":"string","example":"index,follow"}}},"HomepageSection":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","example":"hero"},"title":{"type":"string"},"subtitle":{"type":"string","nullable":true},"content":{"type":"string","nullable":true},"media_url":{"type":"string","nullable":true},"cta_label":{"type":"string","nullable":true},"cta_url":{"type":"string","nullable":true},"sort_order":{"type":"integer"},"enabled":{"type":"boolean"},"settings":{"type":"object","nullable":true}}},"HomepageSectionInput":{"type":"object","required":["type","title"],"properties":{"type":{"type":"string","enum":["hero","category_grid","featured_products","rich_text","image_banner","cta","navigation","puck_page"]},"title":{"type":"string"},"subtitle":{"type":"string","nullable":true},"content":{"type":"string","nullable":true},"media_url":{"type":"string","nullable":true},"cta_label":{"type":"string","nullable":true},"cta_url":{"type":"string","nullable":true},"sort_order":{"type":"integer","default":0},"enabled":{"type":"boolean","default":true},"settings":{"type":"object","nullable":true}}},"HomepageReorder":{"type":"object","required":["section_ids"],"properties":{"section_ids":{"type":"array","items":{"type":"string"}}}},"PuckPage":{"type":"object","properties":{"schema":{"type":"string","example":"aurelio.puck-page"},"version":{"type":"integer","example":1},"page_key":{"type":"string","example":"home"},"root":{"type":"object"},"content":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"Hero"},"props":{"type":"object"}}}}}},"SaasPlan":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string","example":"launch"},"name":{"type":"string","example":"Launch"},"description":{"type":"string","nullable":true},"price_amount":{"type":"integer","example":2900},"currency_code":{"type":"string","example":"eur"},"billing_interval":{"type":"string","enum":["monthly","yearly"]},"trial_days":{"type":"integer"},"features":{"type":"array","items":{"type":"string"}}}},"SaasPlanInput":{"type":"object","required":["slug","name"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"price_amount":{"type":"integer","default":0},"currency_code":{"type":"string","default":"eur"},"billing_interval":{"type":"string","enum":["monthly","yearly"],"default":"monthly"},"trial_days":{"type":"integer","default":0},"is_active":{"type":"boolean","default":true},"provider_price_id":{"type":"string","nullable":true},"features":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","nullable":true}}},"CreateSaasCheckout":{"type":"object","required":["store_name","owner_email"],"properties":{"plan_slug":{"type":"string","default":"launch"},"store_name":{"type":"string","example":"Atelier Demo"},"store_slug":{"type":"string","example":"atelier-demo"},"owner_email":{"type":"string","format":"email"},"owner_name":{"type":"string","nullable":true},"success_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"},"metadata":{"type":"object","nullable":true}}},"SaasCheckoutResult":{"type":"object","properties":{"store":{"$ref":"#/components/schemas/PublicSaasStore"},"checkout":{"type":"object","properties":{"id":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"requires_payment_configuration":{"type":"boolean"}}}}},"PublicSaasStoreEnvelope":{"type":"object","properties":{"store":{"$ref":"#/components/schemas/PublicSaasStore"}}},"PublicSaasStore":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string","example":"atelier-demo"},"store_name":{"type":"string"},"plan_slug":{"type":"string"},"status":{"type":"string"},"provisioning_status":{"type":"string"},"billing_status":{"type":"string"},"storefront_url":{"type":"string","example":"https://atelier-demo.myaurelio.com"},"admin_url":{"type":"string","nullable":true},"last_provisioning_error":{"type":"string","nullable":true}}},"TenantResolveResult":{"type":"object","properties":{"tenant":{"allOf":[{"$ref":"#/components/schemas/PublicSaasStore"},{"type":"object","properties":{"backend_url":{"type":"string","nullable":true},"backend_project_id":{"type":"string","nullable":true},"storefront_project_id":{"type":"string","nullable":true}}}]}}},"BillingPortalRequest":{"type":"object","properties":{"return_url":{"type":"string","format":"uri"}}},"PlanChangeRequest":{"type":"object","required":["target_plan_slug"],"properties":{"target_plan_slug":{"type":"string"},"return_url":{"type":"string","format":"uri"}}},"TenantDomainRequest":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","example":"shop.example.com"},"status":{"type":"string","enum":["requested","verifying","active","failed"]},"verification_type":{"type":"string","enum":["cname","txt"],"default":"cname"},"metadata":{"type":"object","nullable":true}}},"TenantDomainVerification":{"type":"object","properties":{"status":{"type":"string","enum":["requested","verifying","active","failed"],"default":"verifying"},"error_message":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true}}},"SaasStoreStatusUpdate":{"type":"object","properties":{"status":{"type":"string"},"provisioning_status":{"type":"string"},"billing_status":{"type":"string"},"billing_lifecycle_status":{"type":"string"},"billing_override_reason":{"type":"string","nullable":true},"pending_plan_slug":{"type":"string","nullable":true},"operator_reason":{"type":"string"}}},"TenantDeploymentRequest":{"type":"object","properties":{"action":{"type":"string","enum":["deploy","redeploy","suspend","cancel"]},"provider":{"type":"string","default":"vercel"},"backend_project_id":{"type":"string"},"storefront_project_id":{"type":"string"},"backend_url":{"type":"string","format":"uri"},"admin_url":{"type":"string","format":"uri"},"storefront_url":{"type":"string","format":"uri"},"operator_reason":{"type":"string"},"metadata":{"type":"object","nullable":true}}},"UsageLimitCheck":{"type":"object","required":["resource"],"properties":{"resource":{"type":"string","enum":["products","team_members","custom_domains","themes","pages","monthly_orders","monthly_gmv"]},"requested_increment":{"type":"integer","default":1}}},"SuperadminAlertUpdate":{"type":"object","required":["status","operator_reason"],"properties":{"status":{"type":"string","enum":["open","acknowledged","resolved"]},"operator_reason":{"type":"string"}}},"ProvisioningResult":{"type":"object","required":["status"],"properties":{"store_id":{"type":"string"},"tenant_id":{"type":"string"},"store_slug":{"type":"string"},"status":{"type":"string","enum":["active","failed","provisioning","suspended","cancelled"]},"backend_project_id":{"type":"string"},"storefront_project_id":{"type":"string"},"backend_url":{"type":"string","format":"uri"},"storefront_url":{"type":"string","format":"uri"},"admin_url":{"type":"string","format":"uri"},"database_url_reference":{"type":"string"},"error_message":{"type":"string"},"metadata":{"type":"object","nullable":true}}}}}}