{"openapi":"3.0.3","info":{"title":"Max QR Code API","version":"0.1.0","description":"REST API for static QR generation, dynamic codes, bulk jobs, analytics, projects, domains, and teams. Authenticate with a Supabase user JWT or a workspace API key (mq_live_…). API key create/list requires Business (features.apiKeys). Human docs: https://getmaxqr.com/docs"},"servers":[{"url":"https://api.getmaxqr.com"}],"tags":[{"name":"meta"},{"name":"generate"},{"name":"dynamic"},{"name":"bulk"},{"name":"analytics"},{"name":"projects"},{"name":"redirects"},{"name":"billing"},{"name":"account"},{"name":"domains"},{"name":"teams"},{"name":"campaigns"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Supabase JWT or mq_live_ API key"},"apiKey":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string","format":"uuid"}}}}},"GenerateRequest":{"type":"object","required":["content"],"properties":{"content":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["url","text","wifi","vcard","email","tel","sms","geo","payment"]},"data":{"type":"object"}}},"format":{"type":"string","enum":["png","svg","pdf"],"default":"png"},"preset":{"type":"string"},"style":{"type":"object"},"response":{"type":"string","enum":["binary","json"]}}},"DynamicCodeCreate":{"type":"object","required":["destination_url"],"properties":{"name":{"type":"string"},"destination_url":{"type":"string","format":"uri"},"slug":{"type":"string"},"expires_at":{"type":"string","format":"date-time","nullable":true}}},"BulkJobCreate":{"type":"object","properties":{"name":{"type":"string"},"content_type":{"type":"string","default":"url"},"format":{"type":"string","enum":["png","svg"],"default":"png"},"csv":{"type":"string","description":"CSV text with header row"},"rows":{"type":"array","items":{"type":"object"},"description":"Alternative to csv"},"style":{"type":"object"},"preset":{"type":"string"}}}}},"paths":{"/api/health":{"get":{"tags":["meta"],"summary":"Liveness + storage stats","x-maxqr-auth":"none","responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/ready":{"get":{"tags":["meta"],"summary":"Readiness (disk + Supabase)","x-maxqr-auth":"none","responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1":{"get":{"tags":["meta"],"summary":"API catalog","x-maxqr-auth":"none","responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/openapi.json":{"get":{"tags":["meta"],"summary":"OpenAPI 3 document","x-maxqr-auth":"none","responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/generate/options":{"get":{"tags":["generate"],"summary":"QR engine options","x-maxqr-auth":"none","responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/generate":{"post":{"tags":["generate"],"summary":"Generate static QR (guest OK)","x-maxqr-scope":"generate","x-maxqr-auth":"optional","security":[{"bearerAuth":[]},{"apiKey":[]},{}],"responses":{"200":{"description":"Binary image or JSON { format, mime, meta, auth, data_base64 }"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRequest"}}}}}},"/api/v1/generate/upload":{"post":{"tags":["generate"],"summary":"Generate with multipart logo","x-maxqr-scope":"generate","x-maxqr-auth":"optional","security":[{"bearerAuth":[]},{"apiKey":[]},{}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/generate/preview":{"post":{"tags":["generate"],"summary":"Preview QR (JSON)","x-maxqr-scope":"generate","x-maxqr-auth":"optional","security":[{"bearerAuth":[]},{"apiKey":[]},{}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/billing/status":{"get":{"tags":["billing"],"summary":"Premium / Stripe / email status","x-maxqr-auth":"none","responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/billing/plans":{"get":{"tags":["billing"],"summary":"Plan catalog","x-maxqr-auth":"none","responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/billing/me":{"get":{"tags":["billing"],"summary":"Current user plan","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/billing/workspaces/{workspaceId}":{"get":{"tags":["billing"],"summary":"Workspace billing + credits","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/billing/workspaces/{workspaceId}/credits":{"get":{"tags":["billing"],"summary":"Credit packs / WL flag","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/billing/workspaces/{workspaceId}/checkout":{"post":{"tags":["billing"],"summary":"Stripe Checkout (premium on)","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/billing/workspaces/{workspaceId}/credits/checkout":{"post":{"tags":["billing"],"summary":"Credit pack Checkout (premium on)","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/billing/workspaces/{workspaceId}/portal":{"post":{"tags":["billing"],"summary":"Stripe Customer Portal","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/me":{"get":{"tags":["account"],"summary":"Profile + workspaces","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"patch":{"tags":["account"],"summary":"Update profile / preferences","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces":{"get":{"tags":["account"],"summary":"List workspaces","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"post":{"tags":["account"],"summary":"Create workspace","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{id}":{"get":{"tags":["account"],"summary":"Get workspace","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{id}/transfer":{"post":{"tags":["account"],"summary":"Transfer ownership","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{id}/api-keys":{"get":{"tags":["account"],"summary":"List API keys (Business)","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"post":{"tags":["account"],"summary":"Create API key (Business)","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{id}/api-keys/{keyId}":{"delete":{"tags":["account"],"summary":"Revoke API key","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{id}/api-keys/{keyId}/rotate":{"post":{"tags":["account"],"summary":"Rotate API key","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/projects":{"get":{"tags":["projects"],"summary":"List projects","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"post":{"tags":["projects"],"summary":"Create project","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/projects/{projectId}":{"get":{"tags":["projects"],"summary":"Get project","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"patch":{"tags":["projects"],"summary":"Update project","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"delete":{"tags":["projects"],"summary":"Archive / hard-delete project","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/projects/{projectId}/duplicate":{"post":{"tags":["projects"],"summary":"Duplicate project","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/projects/{projectId}/versions":{"get":{"tags":["projects"],"summary":"List project versions","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/projects/{projectId}/versions/{version}/restore":{"post":{"tags":["projects"],"summary":"Restore project version","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/projects/{projectId}/render":{"post":{"tags":["projects"],"summary":"Render project QR","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/projects/{projectId}/assets/logo":{"post":{"tags":["projects"],"summary":"Upload project logo","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/projects/{projectId}/assets/{kind}":{"get":{"tags":["projects"],"summary":"Download project logo or preview","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/brand-assets":{"get":{"tags":["projects"],"summary":"List brand assets","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"post":{"tags":["projects"],"summary":"Upload brand asset","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/brand-assets/{assetId}":{"get":{"tags":["projects"],"summary":"Download brand asset","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"delete":{"tags":["projects"],"summary":"Delete brand asset","x-maxqr-scope":"projects","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/dynamic-codes":{"get":{"tags":["dynamic"],"summary":"List dynamic codes (Pro+)","x-maxqr-scope":"dynamic","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"post":{"tags":["dynamic"],"summary":"Create dynamic code (Pro+)","x-maxqr-scope":"dynamic","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created — body { code: DynamicCode }"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DynamicCodeCreate"}}}}}},"/api/v1/workspaces/{workspaceId}/dynamic-codes/{codeId}":{"get":{"tags":["dynamic"],"summary":"Get dynamic code","x-maxqr-scope":"dynamic","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"codeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"patch":{"tags":["dynamic"],"summary":"Update dynamic code","x-maxqr-scope":"dynamic","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"codeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"delete":{"tags":["dynamic"],"summary":"Delete dynamic code","x-maxqr-scope":"dynamic","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"codeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/dynamic-codes/{codeId}/activate":{"post":{"tags":["dynamic"],"summary":"Activate code","x-maxqr-scope":"dynamic","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"codeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/dynamic-codes/{codeId}/deactivate":{"post":{"tags":["dynamic"],"summary":"Deactivate code","x-maxqr-scope":"dynamic","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"codeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/bulk-jobs":{"get":{"tags":["bulk"],"summary":"List bulk jobs (Business)","x-maxqr-scope":"bulk","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"post":{"tags":["bulk"],"summary":"Enqueue bulk job (Business)","x-maxqr-scope":"bulk","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"202":{"description":"Queued — body { job, credits_used }"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkJobCreate"}}}}}},"/api/v1/workspaces/{workspaceId}/bulk-jobs/{jobId}":{"get":{"tags":["bulk"],"summary":"Get bulk job","x-maxqr-scope":"bulk","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"delete":{"tags":["bulk"],"summary":"Cancel / delete job","x-maxqr-scope":"bulk","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/bulk-jobs/{jobId}/download":{"get":{"tags":["bulk"],"summary":"Download ZIP","x-maxqr-scope":"bulk","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/bulk-jobs/{jobId}/mapping":{"get":{"tags":["bulk"],"summary":"Download mapping CSV","x-maxqr-scope":"bulk","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/analytics/codes/{codeId}":{"get":{"tags":["analytics"],"summary":"Code analytics (Pro+)","x-maxqr-scope":"analytics","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"codeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/analytics/codes/{codeId}/csv":{"get":{"tags":["analytics"],"summary":"Export scans CSV","x-maxqr-scope":"analytics","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"codeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/analytics/compare":{"get":{"tags":["analytics"],"summary":"Compare codes","x-maxqr-scope":"analytics","x-maxqr-auth":"user|api_key","security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/domains":{"get":{"tags":["domains"],"summary":"List custom domains (Business)","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"post":{"tags":["domains"],"summary":"Add custom domain","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/domains/{domainId}":{"get":{"tags":["domains"],"summary":"Get domain","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"domainId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"delete":{"tags":["domains"],"summary":"Delete domain","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"domainId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/domains/{domainId}/verify":{"post":{"tags":["domains"],"summary":"Verify DNS","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"domainId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/domains/{domainId}/primary":{"post":{"tags":["domains"],"summary":"Set primary domain","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"domainId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/members":{"get":{"tags":["teams"],"summary":"List members (Business seats)","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/members/{userId}":{"patch":{"tags":["teams"],"summary":"Change member role","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"delete":{"tags":["teams"],"summary":"Remove member","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/members/leave":{"post":{"tags":["teams"],"summary":"Leave workspace","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/invites":{"get":{"tags":["teams"],"summary":"List invites","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"post":{"tags":["teams"],"summary":"Create invite","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/invites/{inviteId}":{"delete":{"tags":["teams"],"summary":"Revoke invite","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"inviteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/invites/accept":{"post":{"tags":["teams"],"summary":"Accept invite","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/invites/{token}/preview":{"get":{"tags":["teams"],"summary":"Preview invite","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/campaigns":{"get":{"tags":["campaigns"],"summary":"List campaigns","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"post":{"tags":["campaigns"],"summary":"Create campaign","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/campaigns/bulk":{"post":{"tags":["campaigns"],"summary":"Bulk update campaign status","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/campaigns/folders":{"get":{"tags":["campaigns"],"summary":"List folders","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"post":{"tags":["campaigns"],"summary":"Create folder","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/campaigns/folders/{folderId}":{"patch":{"tags":["campaigns"],"summary":"Update folder","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"delete":{"tags":["campaigns"],"summary":"Delete folder","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/campaigns/tags":{"get":{"tags":["campaigns"],"summary":"List tags","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"post":{"tags":["campaigns"],"summary":"Create tag","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/campaigns/tags/{tagId}":{"delete":{"tags":["campaigns"],"summary":"Delete tag","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"tagId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/campaigns/{campaignId}":{"get":{"tags":["campaigns"],"summary":"Get campaign","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"campaignId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"patch":{"tags":["campaigns"],"summary":"Update campaign","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"campaignId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}},"delete":{"tags":["campaigns"],"summary":"Archive / hard-delete campaign","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"campaignId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/campaigns/{campaignId}/codes":{"post":{"tags":["campaigns"],"summary":"Attach dynamic codes","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"campaignId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/campaigns/{campaignId}/codes/{codeId}":{"delete":{"tags":["campaigns"],"summary":"Detach dynamic code","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"campaignId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"codeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/workspaces/{workspaceId}/campaigns/{campaignId}/duplicate":{"post":{"tags":["campaigns"],"summary":"Duplicate campaign","x-maxqr-auth":"user","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"campaignId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/r/{slug}":{"get":{"tags":["redirects"],"summary":"Public 302 redirect","x-maxqr-auth":"none","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/r/{slug}/status":{"get":{"tags":["redirects"],"summary":"Public code status (no destination)","x-maxqr-auth":"none","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Status JSON — { slug, status, expires_at } (no destination_url)"},"201":{"description":"Created"},"202":{"description":"Accepted"},"204":{"description":"No content"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden / plan / scope"},"404":{"description":"Not found"},"409":{"description":"Conflict / not_ready"},"429":{"description":"Rate limited"}}}},"/api/v1/billing/webhook":{"post":{"tags":["billing"],"summary":"Stripe webhooks (raw body + Stripe-Signature)","x-maxqr-auth":"stripe","responses":{"200":{"description":"Received"},"400":{"description":"Invalid signature"},"503":{"description":"Billing unavailable / premium_coming_soon"}}}}}}