{"openapi":"3.0.3","info":{"title":"MiniPDF API","version":"1.1.0","description":"Generated from src/contracts/api-contract.ts"},"servers":[{"url":"https://minipdf.org"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/health":{"get":{"operationId":"health","tags":["System"],"summary":"Service health","description":"Returns service health status.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"status":{"type":"string","title":"Status","x-ms-summary":"Status"}},"required":["success","status"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"status":"ok"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}}}},"/v1/plans":{"get":{"operationId":"plans","tags":["Plans"],"summary":"List plans","description":"Returns available subscription plans.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"plans":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"name":{"type":"string","title":"Name","x-ms-summary":"Name"},"monthlyQuota":{"type":"number","title":"Monthly Quota","x-ms-summary":"Monthly Quota"},"rateLimitPerMinute":{"type":"number","title":"Rate Limit Per Minute","x-ms-summary":"Rate Limit Per Minute"},"maxApiKeys":{"type":"number","title":"Max Api Keys","x-ms-summary":"Max Api Keys"}},"required":["code","name","monthlyQuota","rateLimitPerMinute","maxApiKeys"],"additionalProperties":false},"title":"Plans","x-ms-summary":"Plans"}},"required":["success","plans"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"plans":[{"code":"free","name":"Free","monthlyQuota":300,"rateLimitPerMinute":75,"maxApiKeys":1}]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}}}},"/v1/support/requests":{"post":{"operationId":"supportCreateRequest","tags":["Support"],"summary":"Create support request","description":"Creates a tracked support or sales request without relying on email.","parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"request":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"topic":{"type":"string","title":"Topic","x-ms-summary":"Topic"},"status":{"type":"string","title":"Status","x-ms-summary":"Status"},"requestedPlanCode":{"type":"string","title":"Requested Plan Code","x-ms-summary":"Requested Plan Code"}},"required":["id","topic","status","requestedPlanCode"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"}},"required":["success","request"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"request":{"id":"sup_123","topic":"SALES","status":"OPEN","requestedPlanCode":"pro"}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","title":"Email","x-ms-summary":"Email"},"fullName":{"type":"string","title":"Full Name","x-ms-summary":"Full Name"},"topic":{"type":"string","title":"Topic","x-ms-summary":"Topic"},"subject":{"type":"string","title":"Subject","x-ms-summary":"Subject"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"requestedPlanCode":{"type":"string","title":"Requested Plan Code","x-ms-summary":"Requested Plan Code"}},"required":["email","fullName","topic","subject","message","requestedPlanCode"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"email":"buyer@example.com","fullName":"Buyer Team","topic":"SALES","subject":"Need Growth plan details","message":"We expect 20k requests per month and want to discuss onboarding.","requestedPlanCode":"pro"}}}}}},"/v1/auth/register":{"post":{"operationId":"authRegister","tags":["Auth"],"summary":"Register user","description":"Creates a new user account.","parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"user":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"email":{"type":"string","title":"Email","x-ms-summary":"Email"},"fullName":{"type":"string","title":"Full Name","x-ms-summary":"Full Name"},"role":{"type":"string","title":"Role","x-ms-summary":"Role"},"emailVerified":{"type":"boolean","title":"Email Verified","x-ms-summary":"Email Verified"},"createdAt":{"type":"string","title":"Created At","x-ms-summary":"Created At"}},"required":["id","email","fullName","role","emailVerified","createdAt"],"additionalProperties":false,"title":"User","x-ms-summary":"User"}},"required":["success","user"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"user":{"id":"usr_123","email":"user@example.com","fullName":"Test User","role":"USER","emailVerified":false,"createdAt":"2026-03-12T00:00:00.000Z"}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","title":"Email","x-ms-summary":"Email"},"password":{"type":"string","title":"Password","x-ms-summary":"Password"},"fullName":{"type":"string","title":"Full Name","x-ms-summary":"Full Name"}},"required":["email","password","fullName"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"email":"user@example.com","password":"password123","fullName":"Test User"}}}}}},"/v1/auth/login":{"post":{"operationId":"authLogin","tags":["Auth"],"summary":"Login user","description":"Authenticates a user and returns JWT access token.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"accessToken":{"type":"string","title":"Access Token","x-ms-summary":"Access Token"},"expiresAt":{"type":"string","title":"Expires At","x-ms-summary":"Expires At"},"user":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"email":{"type":"string","title":"Email","x-ms-summary":"Email"},"fullName":{"type":"string","title":"Full Name","x-ms-summary":"Full Name"},"role":{"type":"string","title":"Role","x-ms-summary":"Role"},"emailVerified":{"type":"boolean","title":"Email Verified","x-ms-summary":"Email Verified"},"createdAt":{"type":"string","title":"Created At","x-ms-summary":"Created At"}},"required":["id","email","fullName","role","emailVerified","createdAt"],"additionalProperties":false,"title":"User","x-ms-summary":"User"}},"required":["success","accessToken","expiresAt","user"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"accessToken":"<jwt>","expiresAt":"2026-03-13T00:00:00.000Z","user":{"id":"usr_123","email":"user@example.com","fullName":"Test User","role":"USER","emailVerified":false,"createdAt":"2026-03-12T00:00:00.000Z"}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","title":"Email","x-ms-summary":"Email"},"password":{"type":"string","title":"Password","x-ms-summary":"Password"}},"required":["email","password"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"email":"user@example.com","password":"password123"}}}}}},"/v1/auth/verify-email/request":{"post":{"operationId":"authRequestEmailVerification","tags":["Auth"],"summary":"Request email verification","description":"Issues a verification token for the current authenticated user.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"expiresAt":{"type":"string","title":"Expires At","x-ms-summary":"Expires At"},"previewToken":{"type":"string","title":"Preview Token","x-ms-summary":"Preview Token"}},"required":["success","expiresAt","previewToken"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"expiresAt":"2026-03-20T12:00:00.000Z","previewToken":"<verification_token>"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{}}}},"security":[{"BearerAuth":[]}]}},"/v1/auth/verify-email":{"post":{"operationId":"authVerifyEmail","tags":["Auth"],"summary":"Verify email","description":"Marks a user email as verified using a verification token.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"user":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"email":{"type":"string","title":"Email","x-ms-summary":"Email"},"fullName":{"type":"string","title":"Full Name","x-ms-summary":"Full Name"},"role":{"type":"string","title":"Role","x-ms-summary":"Role"},"emailVerified":{"type":"boolean","title":"Email Verified","x-ms-summary":"Email Verified"},"createdAt":{"type":"string","title":"Created At","x-ms-summary":"Created At"}},"required":["id","email","fullName","role","emailVerified","createdAt"],"additionalProperties":false,"title":"User","x-ms-summary":"User"}},"required":["success","user"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"user":{"id":"usr_123","email":"user@example.com","fullName":"Test User","role":"USER","emailVerified":true,"createdAt":"2026-03-12T00:00:00.000Z"}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","title":"Token","x-ms-summary":"Token"}},"required":["token"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"token":"<verification_token>"}}}}}},"/v1/auth/password-reset/request":{"post":{"operationId":"authRequestPasswordReset","tags":["Auth"],"summary":"Request password reset","description":"Issues a password reset token for an existing user email.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"expiresAt":{"type":"string","title":"Expires At","x-ms-summary":"Expires At"},"previewToken":{"type":"string","title":"Preview Token","x-ms-summary":"Preview Token"}},"required":["success","expiresAt","previewToken"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"expiresAt":"2026-03-20T08:00:00.000Z","previewToken":"<reset_token>"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","title":"Email","x-ms-summary":"Email"}},"required":["email"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"email":"user@example.com"}}}}}},"/v1/auth/password-reset/confirm":{"post":{"operationId":"authConfirmPasswordReset","tags":["Auth"],"summary":"Confirm password reset","description":"Resets the password using a valid password reset token.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"}},"required":["success"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","title":"Token","x-ms-summary":"Token"},"password":{"type":"string","title":"Password","x-ms-summary":"Password"},"confirmPassword":{"type":"string","title":"Confirm Password","x-ms-summary":"Confirm Password"}},"required":["token","password","confirmPassword"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"token":"<reset_token>","password":"NewStrongPassword123","confirmPassword":"NewStrongPassword123"}}}}}},"/v1/auth/google/config":{"get":{"operationId":"googleConfig","tags":["Auth"],"summary":"Google login config","description":"Returns whether Google login is enabled and client id.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"enabled":{"type":"boolean","title":"Enabled","x-ms-summary":"Enabled"},"clientId":{"type":"string","title":"Client Id","x-ms-summary":"Client Id"}},"required":["success","enabled","clientId"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"enabled":false,"clientId":""}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}}}},"/v1/auth/google":{"post":{"operationId":"googleLogin","tags":["Auth"],"summary":"Login with Google ID token","description":"Authenticates via Google ID token and returns JWT access token.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"accessToken":{"type":"string","title":"Access Token","x-ms-summary":"Access Token"}},"required":["success","accessToken"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"accessToken":"<jwt>"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"idToken":{"type":"string","title":"Id Token","x-ms-summary":"Id Token"}},"required":["idToken"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"idToken":"<google_id_token>"}}}}}},"/v1/account/me":{"get":{"operationId":"accountMe","tags":["Account"],"summary":"Current account profile","description":"Returns current authenticated user and active subscription.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"user":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"email":{"type":"string","title":"Email","x-ms-summary":"Email"},"role":{"type":"string","title":"Role","x-ms-summary":"Role"},"emailVerified":{"type":"boolean","title":"Email Verified","x-ms-summary":"Email Verified"}},"required":["id","email","role","emailVerified"],"additionalProperties":false,"title":"User","x-ms-summary":"User"},"subscription":{"type":"object","properties":{"status":{"type":"string","title":"Status","x-ms-summary":"Status"},"billingCycle":{"type":"string","title":"Billing Cycle","x-ms-summary":"Billing Cycle"},"currentPeriodStart":{"type":"string","title":"Current Period Start","x-ms-summary":"Current Period Start"},"currentPeriodEnd":{"nullable":true},"cancelAtPeriodEnd":{"type":"boolean","title":"Cancel At Period End","x-ms-summary":"Cancel At Period End"},"plan":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"}},"required":["code"],"additionalProperties":false,"title":"Plan","x-ms-summary":"Plan"}},"required":["status","billingCycle","currentPeriodStart","currentPeriodEnd","cancelAtPeriodEnd","plan"],"additionalProperties":false,"title":"Subscription","x-ms-summary":"Subscription"}},"required":["success","user","subscription"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"user":{"id":"usr_123","email":"user@example.com","role":"USER","emailVerified":true},"subscription":{"status":"ACTIVE","billingCycle":"MONTHLY","currentPeriodStart":"2026-03-01T00:00:00.000Z","currentPeriodEnd":null,"cancelAtPeriodEnd":false,"plan":{"code":"free"}}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/account/subscription":{"get":{"operationId":"accountSubscription","tags":["Account"],"summary":"Current subscription","description":"Returns current authenticated user subscription.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"subscription":{"type":"object","properties":{"status":{"type":"string","title":"Status","x-ms-summary":"Status"},"billingCycle":{"type":"string","title":"Billing Cycle","x-ms-summary":"Billing Cycle"},"currentPeriodStart":{"type":"string","title":"Current Period Start","x-ms-summary":"Current Period Start"},"currentPeriodEnd":{"nullable":true},"cancelAtPeriodEnd":{"type":"boolean","title":"Cancel At Period End","x-ms-summary":"Cancel At Period End"},"plan":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"monthlyQuota":{"type":"number","title":"Monthly Quota","x-ms-summary":"Monthly Quota"},"rateLimitPerMinute":{"type":"number","title":"Rate Limit Per Minute","x-ms-summary":"Rate Limit Per Minute"},"maxApiKeys":{"type":"number","title":"Max Api Keys","x-ms-summary":"Max Api Keys"}},"required":["code","monthlyQuota","rateLimitPerMinute","maxApiKeys"],"additionalProperties":false,"title":"Plan","x-ms-summary":"Plan"}},"required":["status","billingCycle","currentPeriodStart","currentPeriodEnd","cancelAtPeriodEnd","plan"],"additionalProperties":false,"title":"Subscription","x-ms-summary":"Subscription"}},"required":["success","subscription"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"subscription":{"status":"ACTIVE","billingCycle":"MONTHLY","currentPeriodStart":"2026-03-01T00:00:00.000Z","currentPeriodEnd":null,"cancelAtPeriodEnd":false,"plan":{"code":"free","monthlyQuota":300,"rateLimitPerMinute":75,"maxApiKeys":1}}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/account/plan-requests":{"get":{"operationId":"accountListPlanRequests","tags":["Account"],"summary":"List plan upgrade requests","description":"Returns plan upgrade requests for current user.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"status":{"type":"string","title":"Status","x-ms-summary":"Status"},"sourcePlanCode":{"type":"string","title":"Source Plan Code","x-ms-summary":"Source Plan Code"},"requestedBillingCycle":{"type":"string","title":"Requested Billing Cycle","x-ms-summary":"Requested Billing Cycle"},"targetPlan":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"name":{"type":"string","title":"Name","x-ms-summary":"Name"},"maxApiKeys":{"type":"number","title":"Max Api Keys","x-ms-summary":"Max Api Keys"}},"required":["code","name","maxApiKeys"],"additionalProperties":false,"title":"Target Plan","x-ms-summary":"Target Plan"}},"required":["id","status","sourcePlanCode","requestedBillingCycle","targetPlan"],"additionalProperties":false},"title":"Requests","x-ms-summary":"Requests"}},"required":["success","requests"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"requests":[{"id":"req_123","status":"PENDING","sourcePlanCode":"free","requestedBillingCycle":"YEARLY","targetPlan":{"code":"starter","name":"Starter","maxApiKeys":3}}]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"accountCreatePlanRequest","tags":["Account"],"summary":"Create plan upgrade request","description":"Creates a manual plan upgrade request for the current user.","parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"request":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"status":{"type":"string","title":"Status","x-ms-summary":"Status"},"sourcePlanCode":{"type":"string","title":"Source Plan Code","x-ms-summary":"Source Plan Code"},"requestedBillingCycle":{"type":"string","title":"Requested Billing Cycle","x-ms-summary":"Requested Billing Cycle"},"targetPlan":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"name":{"type":"string","title":"Name","x-ms-summary":"Name"},"maxApiKeys":{"type":"number","title":"Max Api Keys","x-ms-summary":"Max Api Keys"}},"required":["code","name","maxApiKeys"],"additionalProperties":false,"title":"Target Plan","x-ms-summary":"Target Plan"}},"required":["id","status","sourcePlanCode","requestedBillingCycle","targetPlan"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"}},"required":["success","request"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"request":{"id":"req_123","status":"PENDING","sourcePlanCode":"free","requestedBillingCycle":"YEARLY","targetPlan":{"code":"starter","name":"Starter","maxApiKeys":3}}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"planCode":{"type":"string","title":"Plan Code","x-ms-summary":"Plan Code"},"billingCycle":{"type":"string","title":"Billing Cycle","x-ms-summary":"Billing Cycle"},"note":{"type":"string","title":"Note","x-ms-summary":"Note"}},"required":["planCode","billingCycle","note"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"planCode":"starter","billingCycle":"YEARLY","note":"Need more quota for client pilot"}}}},"security":[{"BearerAuth":[]}]}},"/v1/account/api-keys":{"get":{"operationId":"accountListApiKeys","tags":["Account"],"summary":"List API keys","description":"Returns API keys for current user.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"apiKeys":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"name":{"type":"string","title":"Name","x-ms-summary":"Name"},"keyPrefix":{"type":"string","title":"Key Prefix","x-ms-summary":"Key Prefix"},"plan":{"type":"string","title":"Plan","x-ms-summary":"Plan"},"status":{"type":"string","title":"Status","x-ms-summary":"Status"}},"required":["id","name","keyPrefix","plan","status"],"additionalProperties":false},"title":"Api Keys","x-ms-summary":"Api Keys"}},"required":["success","apiKeys"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"apiKeys":[{"id":"key_123","name":"default-key","keyPrefix":"pdf_abcdef","plan":"free","status":"ACTIVE"}]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]},"post":{"operationId":"accountCreateApiKey","tags":["Account"],"summary":"Create API key","description":"Creates a new API key and returns plaintext key once.","parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"apiKey":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"name":{"type":"string","title":"Name","x-ms-summary":"Name"},"keyPrefix":{"type":"string","title":"Key Prefix","x-ms-summary":"Key Prefix"},"plan":{"type":"string","title":"Plan","x-ms-summary":"Plan"},"status":{"type":"string","title":"Status","x-ms-summary":"Status"}},"required":["id","name","keyPrefix","plan","status"],"additionalProperties":false,"title":"Api Key","x-ms-summary":"Api Key"},"plaintextKey":{"type":"string","title":"Plaintext Key","x-ms-summary":"Plaintext Key"}},"required":["success","apiKey","plaintextKey"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"apiKey":{"id":"key_123","name":"main-key","keyPrefix":"pdf_abcdef","plan":"free","status":"ACTIVE"},"plaintextKey":"pdf_xxxxxxxxxxxxxxxxx"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","title":"Name","x-ms-summary":"Name"}},"required":["name"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"name":"main-key"}}}},"security":[{"BearerAuth":[]}]}},"/v1/account/api-keys/{id}":{"delete":{"operationId":"accountRevokeApiKey","tags":["Account"],"summary":"Revoke API key","description":"Revokes an API key by id.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Path parameter: id"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"}},"required":["success"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/account/api-keys/{id}/reactivate":{"post":{"operationId":"accountReactivateApiKey","tags":["Account"],"summary":"Reactivate API key","description":"Reactivates an API key suspended by plan limits.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Path parameter: id"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"}},"required":["success"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/account/api-keys/{id}/permanent":{"delete":{"operationId":"accountDeleteApiKeyPermanently","tags":["Account"],"summary":"Delete revoked API key","description":"Deletes an API key permanently after it has been revoked.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Path parameter: id"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"}},"required":["success"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/account/usage":{"get":{"operationId":"accountUsage","tags":["Account"],"summary":"Usage summary","description":"Returns usage summary for current month or requested period.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"usage":{"type":"object","properties":{"period":{"type":"string","title":"Period","x-ms-summary":"Period"},"totalRequests":{"type":"number","title":"Total Requests","x-ms-summary":"Total Requests"},"successRequests":{"type":"number","title":"Success Requests","x-ms-summary":"Success Requests"},"remainingQuota":{"type":"number","title":"Remaining Quota","x-ms-summary":"Remaining Quota"},"quotaLimit":{"type":"number","title":"Quota Limit","x-ms-summary":"Quota Limit"},"routes":{"type":"array","items":{},"title":"Routes","x-ms-summary":"Routes"}},"required":["period","totalRequests","successRequests","remainingQuota","quotaLimit","routes"],"additionalProperties":false,"title":"Usage","x-ms-summary":"Usage"}},"required":["success","usage"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"usage":{"period":"2026-03","totalRequests":42,"successRequests":40,"remainingQuota":258,"quotaLimit":300,"routes":[]}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/account/billing-history":{"get":{"operationId":"accountBillingHistory","tags":["Account"],"summary":"Billing history","description":"Returns billing and subscription lifecycle events for the current account.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"type":{"type":"string","title":"Type","x-ms-summary":"Type"},"billingCycle":{"type":"string","title":"Billing Cycle","x-ms-summary":"Billing Cycle"},"amountUsd":{"type":"number","title":"Amount Usd","x-ms-summary":"Amount Usd"},"currency":{"type":"string","title":"Currency","x-ms-summary":"Currency"},"referenceCode":{"type":"string","title":"Reference Code","x-ms-summary":"Reference Code"},"periodStart":{"type":"string","title":"Period Start","x-ms-summary":"Period Start"},"periodEnd":{"type":"string","title":"Period End","x-ms-summary":"Period End"},"plan":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"name":{"type":"string","title":"Name","x-ms-summary":"Name"},"maxApiKeys":{"type":"number","title":"Max Api Keys","x-ms-summary":"Max Api Keys"}},"required":["code","name","maxApiKeys"],"additionalProperties":false,"title":"Plan","x-ms-summary":"Plan"},"createdAt":{"type":"string","title":"Created At","x-ms-summary":"Created At"}},"required":["id","type","billingCycle","amountUsd","currency","referenceCode","periodStart","periodEnd","plan","createdAt"],"additionalProperties":false},"title":"Events","x-ms-summary":"Events"}},"required":["success","events"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"events":[{"id":"bill_evt_123","type":"SUBSCRIPTION_RENEWED","billingCycle":"MONTHLY","amountUsd":19,"currency":"USD","referenceCode":"INV-20260319-AB12CD","periodStart":"2026-03-19T00:00:00.000Z","periodEnd":"2026-04-19T00:00:00.000Z","plan":{"code":"starter","name":"Starter","maxApiKeys":3},"createdAt":"2026-03-19T09:00:00.000Z"}]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/account/billing/checkout-session":{"post":{"operationId":"accountCreateCheckoutSession","tags":["Billing"],"summary":"Create billing checkout session","description":"Creates a PayPal checkout session or SePay payment order for a billable public plan.","parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"session":{"type":"object","properties":{"provider":{"type":"string","title":"Provider","x-ms-summary":"Provider"},"mode":{"type":"string","title":"Mode","x-ms-summary":"Mode"},"checkoutId":{"type":"string","title":"Checkout Id","x-ms-summary":"Checkout Id"},"url":{"type":"string","title":"Url","x-ms-summary":"Url"}},"required":["provider","mode","checkoutId","url"],"additionalProperties":false,"title":"Session","x-ms-summary":"Session"}},"required":["success","session"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"session":{"provider":"PAYPAL","mode":"REDIRECT","checkoutId":"I-TEST123","url":"https://www.paypal.com/checkoutnow?token=I-TEST123"}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"planCode":{"type":"string","title":"Plan Code","x-ms-summary":"Plan Code"},"billingCycle":{"type":"string","title":"Billing Cycle","x-ms-summary":"Billing Cycle"},"provider":{"type":"string","title":"Provider","x-ms-summary":"Provider"}},"required":["planCode","billingCycle","provider"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"planCode":"starter","billingCycle":"MONTHLY","provider":"PAYPAL"}}}},"security":[{"BearerAuth":[]}]}},"/v1/account/dashboard":{"get":{"operationId":"accountDashboard","tags":["Account"],"summary":"Dashboard payload","description":"Returns profile, subscription, api keys and usage summary in one payload.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"user":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"email":{"type":"string","title":"Email","x-ms-summary":"Email"},"role":{"type":"string","title":"Role","x-ms-summary":"Role"}},"required":["id","email","role"],"additionalProperties":false,"title":"User","x-ms-summary":"User"},"subscription":{"type":"object","properties":{"status":{"type":"string","title":"Status","x-ms-summary":"Status"},"billingCycle":{"type":"string","title":"Billing Cycle","x-ms-summary":"Billing Cycle"},"currentPeriodStart":{"type":"string","title":"Current Period Start","x-ms-summary":"Current Period Start"},"currentPeriodEnd":{"nullable":true},"cancelAtPeriodEnd":{"type":"boolean","title":"Cancel At Period End","x-ms-summary":"Cancel At Period End"},"plan":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"}},"required":["code"],"additionalProperties":false,"title":"Plan","x-ms-summary":"Plan"}},"required":["status","billingCycle","currentPeriodStart","currentPeriodEnd","cancelAtPeriodEnd","plan"],"additionalProperties":false,"title":"Subscription","x-ms-summary":"Subscription"},"apiKeys":{"type":"array","items":{},"title":"Api Keys","x-ms-summary":"Api Keys"},"usage":{"type":"object","properties":{"period":{"type":"string","title":"Period","x-ms-summary":"Period"},"totalRequests":{"type":"number","title":"Total Requests","x-ms-summary":"Total Requests"},"successRequests":{"type":"number","title":"Success Requests","x-ms-summary":"Success Requests"},"remainingQuota":{"type":"number","title":"Remaining Quota","x-ms-summary":"Remaining Quota"},"quotaLimit":{"type":"number","title":"Quota Limit","x-ms-summary":"Quota Limit"},"routes":{"type":"array","items":{},"title":"Routes","x-ms-summary":"Routes"}},"required":["period","totalRequests","successRequests","remainingQuota","quotaLimit","routes"],"additionalProperties":false,"title":"Usage","x-ms-summary":"Usage"}},"required":["success","user","subscription","apiKeys","usage"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"user":{"id":"usr_123","email":"user@example.com","role":"USER"},"subscription":{"status":"ACTIVE","billingCycle":"MONTHLY","currentPeriodStart":"2026-03-01T00:00:00.000Z","currentPeriodEnd":null,"cancelAtPeriodEnd":false,"plan":{"code":"free"}},"apiKeys":[],"usage":{"period":"2026-03","totalRequests":0,"successRequests":0,"remainingQuota":300,"quotaLimit":300,"routes":[]}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/admin/users":{"get":{"operationId":"adminListUsers","tags":["Admin"],"summary":"Admin list users","description":"Returns users for admin workspace.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"users":{"type":"array","items":{},"title":"Users","x-ms-summary":"Users"}},"required":["success","users"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"users":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/admin/billing-history":{"get":{"operationId":"adminListBillingHistory","tags":["Admin"],"summary":"Admin list billing history","description":"Returns recent billing and subscription lifecycle events across users.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"type":{"type":"string","title":"Type","x-ms-summary":"Type"},"billingCycle":{"type":"string","title":"Billing Cycle","x-ms-summary":"Billing Cycle"},"amountUsd":{"type":"number","title":"Amount Usd","x-ms-summary":"Amount Usd"},"currency":{"type":"string","title":"Currency","x-ms-summary":"Currency"},"referenceCode":{"type":"string","title":"Reference Code","x-ms-summary":"Reference Code"},"plan":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"name":{"type":"string","title":"Name","x-ms-summary":"Name"},"maxApiKeys":{"type":"number","title":"Max Api Keys","x-ms-summary":"Max Api Keys"}},"required":["code","name","maxApiKeys"],"additionalProperties":false,"title":"Plan","x-ms-summary":"Plan"},"user":{"type":"object","properties":{"email":{"type":"string","title":"Email","x-ms-summary":"Email"}},"required":["email"],"additionalProperties":false,"title":"User","x-ms-summary":"User"},"createdAt":{"type":"string","title":"Created At","x-ms-summary":"Created At"}},"required":["id","type","billingCycle","amountUsd","currency","referenceCode","plan","user","createdAt"],"additionalProperties":false},"title":"Events","x-ms-summary":"Events"}},"required":["success","events"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"events":[{"id":"bill_evt_123","type":"SUBSCRIPTION_RENEWED","billingCycle":"MONTHLY","amountUsd":19,"currency":"USD","referenceCode":"INV-20260319-AB12CD","plan":{"code":"starter","name":"Starter","maxApiKeys":3},"user":{"email":"buyer@example.com"},"createdAt":"2026-03-19T09:00:00.000Z"}]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/admin/support-requests":{"get":{"operationId":"adminListSupportRequests","tags":["Admin"],"summary":"Admin list support requests","description":"Returns support and sales requests for admin review.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"email":{"type":"string","title":"Email","x-ms-summary":"Email"},"topic":{"type":"string","title":"Topic","x-ms-summary":"Topic"},"status":{"type":"string","title":"Status","x-ms-summary":"Status"}},"required":["id","email","topic","status"],"additionalProperties":false},"title":"Requests","x-ms-summary":"Requests"}},"required":["success","requests"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"requests":[{"id":"sup_123","email":"buyer@example.com","topic":"SALES","status":"OPEN"}]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/admin/support-requests/{id}":{"patch":{"operationId":"adminReviewSupportRequest","tags":["Admin"],"summary":"Admin review support request","description":"Updates support request status or admin note.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Path parameter: id"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"request":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"status":{"type":"string","title":"Status","x-ms-summary":"Status"},"topic":{"type":"string","title":"Topic","x-ms-summary":"Topic"}},"required":["id","status","topic"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"}},"required":["success","request"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"request":{"id":"sup_123","status":"IN_PROGRESS","topic":"SALES"}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Status","x-ms-summary":"Status"},"adminNote":{"type":"string","title":"Admin Note","x-ms-summary":"Admin Note"}},"required":["status","adminNote"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"status":"IN_PROGRESS","adminNote":"Reached out with pricing deck"}}}},"security":[{"BearerAuth":[]}]}},"/v1/admin/plan-requests":{"get":{"operationId":"adminListPlanRequests","tags":["Admin"],"summary":"Admin list plan requests","description":"Returns manual plan upgrade requests for admin review.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"status":{"type":"string","title":"Status","x-ms-summary":"Status"},"user":{"type":"object","properties":{"email":{"type":"string","title":"Email","x-ms-summary":"Email"}},"required":["email"],"additionalProperties":false,"title":"User","x-ms-summary":"User"},"targetPlan":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"maxApiKeys":{"type":"number","title":"Max Api Keys","x-ms-summary":"Max Api Keys"}},"required":["code","maxApiKeys"],"additionalProperties":false,"title":"Target Plan","x-ms-summary":"Target Plan"}},"required":["id","status","user","targetPlan"],"additionalProperties":false},"title":"Requests","x-ms-summary":"Requests"}},"required":["success","requests"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"requests":[{"id":"req_123","status":"PENDING","user":{"email":"user@example.com"},"targetPlan":{"code":"starter","maxApiKeys":3}}]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/admin/plan-requests/{id}":{"patch":{"operationId":"adminReviewPlanRequest","tags":["Admin"],"summary":"Admin review plan request","description":"Approves or rejects a manual plan upgrade request.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Path parameter: id"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"request":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"status":{"type":"string","title":"Status","x-ms-summary":"Status"},"targetPlan":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"maxApiKeys":{"type":"number","title":"Max Api Keys","x-ms-summary":"Max Api Keys"}},"required":["code","maxApiKeys"],"additionalProperties":false,"title":"Target Plan","x-ms-summary":"Target Plan"}},"required":["id","status","targetPlan"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"}},"required":["success","request"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"request":{"id":"req_123","status":"APPROVED","targetPlan":{"code":"starter","maxApiKeys":3}}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Status","x-ms-summary":"Status"}},"required":["status"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"status":"APPROVED"}}}},"security":[{"BearerAuth":[]}]}},"/v1/admin/users/{id}":{"patch":{"operationId":"adminUpdateUser","tags":["Admin"],"summary":"Admin update user","description":"Updates target user role or plan code.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Path parameter: id"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"user":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"role":{"type":"string","title":"Role","x-ms-summary":"Role"},"subscription":{"type":"object","properties":{"plan":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"}},"required":["code"],"additionalProperties":false,"title":"Plan","x-ms-summary":"Plan"}},"required":["plan"],"additionalProperties":false,"title":"Subscription","x-ms-summary":"Subscription"}},"required":["id","role","subscription"],"additionalProperties":false,"title":"User","x-ms-summary":"User"}},"required":["success","user"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"user":{"id":"usr_target","role":"USER","subscription":{"plan":{"code":"pro"}}}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"type":"string","title":"Role","x-ms-summary":"Role"},"planCode":{"type":"string","title":"Plan Code","x-ms-summary":"Plan Code"}},"required":["role","planCode"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"role":"USER","planCode":"pro"}}}},"security":[{"BearerAuth":[]}]}},"/v1/admin/users/{id}/subscription-actions":{"post":{"operationId":"adminSubscriptionAction","tags":["Admin"],"summary":"Admin subscription action","description":"Renews a paid subscription, sets a custom expiry date, or downgrades the user to free immediately.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Path parameter: id"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"user":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"subscription":{"type":"object","properties":{"billingCycle":{"type":"string","title":"Billing Cycle","x-ms-summary":"Billing Cycle"},"currentPeriodEnd":{"type":"string","title":"Current Period End","x-ms-summary":"Current Period End"},"cancelAtPeriodEnd":{"type":"boolean","title":"Cancel At Period End","x-ms-summary":"Cancel At Period End"},"plan":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"}},"required":["code"],"additionalProperties":false,"title":"Plan","x-ms-summary":"Plan"}},"required":["billingCycle","currentPeriodEnd","cancelAtPeriodEnd","plan"],"additionalProperties":false,"title":"Subscription","x-ms-summary":"Subscription"}},"required":["id","subscription"],"additionalProperties":false,"title":"User","x-ms-summary":"User"}},"required":["success","user"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"user":{"id":"usr_target","subscription":{"billingCycle":"MONTHLY","currentPeriodEnd":"2026-04-18T00:00:00.000Z","cancelAtPeriodEnd":true,"plan":{"code":"starter"}}}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","title":"Action","x-ms-summary":"Action"}},"required":["action"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"action":"RENEW_MONTHLY"}}}},"security":[{"BearerAuth":[]}]}},"/v1/webhooks/paypal":{"post":{"operationId":"paypalWebhook","tags":["Billing"],"summary":"PayPal webhook","description":"Consumes PayPal subscription or payment webhook events and syncs billing state into internal subscriptions.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"processed":{"type":"boolean","title":"Processed","x-ms-summary":"Processed"},"eventType":{"type":"string","title":"Event Type","x-ms-summary":"Event Type"}},"required":["success","processed","eventType"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"processed":true,"eventType":"BILLING.SUBSCRIPTION.ACTIVATED"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"event_type":{"type":"string","title":"Event_type","x-ms-summary":"Event_type"}},"required":["id","event_type"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"id":"WH-123","event_type":"BILLING.SUBSCRIPTION.ACTIVATED"}}}}}},"/v1/webhooks/sepay":{"post":{"operationId":"sepayWebhook","tags":["Billing"],"summary":"SePay webhook","description":"Consumes SePay payment webhook events and activates or renews billing in the internal subscription model.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"processed":{"type":"boolean","title":"Processed","x-ms-summary":"Processed"},"eventType":{"type":"string","title":"Event Type","x-ms-summary":"Event Type"}},"required":["success","processed","eventType"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"processed":true,"eventType":"in"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","title":"Id","x-ms-summary":"Id"},"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"transferType":{"type":"string","title":"Transfer Type","x-ms-summary":"Transfer Type"}},"required":["id","code","transferType"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"id":"sp_123","code":"sp_174243","transferType":"in"}}}}}},"/v1/pdf/add-text-watermark":{"post":{"operationId":"pdfAddTextWatermark","tags":["PDF"],"summary":"Add text watermark","description":"Applies text watermark to a PDF.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name","description":"Name of the source PDF file."},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content","description":"Base64-encoded PDF content. In Power Automate, map this from the File Content token."},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","fileName","contentType","pageCount","fileContentBase64","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"fileName":"sample.watermarked.pdf","contentType":"application/pdf","pageCount":4,"fileContentBase64":"<base64_pdf>","warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name","description":"Name of the source PDF file."},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content","description":"Base64-encoded PDF content. In Power Automate, map this from the File Content token."},"text":{"type":"string","title":"Watermark Text","x-ms-summary":"Watermark Text","description":"Text to draw on each page."},"orientation":{"type":"string","title":"Orientation","x-ms-summary":"Orientation","description":"Watermark text direction on the page.","enum":["diagonal","horizontal"],"x-ms-enum":{"name":"WatermarkOrientation","modelAsString":true,"values":[{"value":"diagonal","displayName":"Diagonal"},{"value":"horizontal","displayName":"Horizontal"}]}},"textColour":{"type":"string","title":"Text Colour","x-ms-summary":"Text Colour","description":"Hex colour for the watermark text, for example #E61123."},"textSize":{"type":"number","title":"Text Size","x-ms-summary":"Text Size","description":"Font size used for the watermark."},"opacity":{"type":"number","title":"Opacity","x-ms-summary":"Opacity","description":"Value between 0 and 1."}},"required":["fileName","fileContentBase64","text","orientation","textColour","textSize","opacity"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","text":"CONFIDENTIAL","orientation":"diagonal","textColour":"#E61123","textSize":120,"opacity":0.2}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/merge":{"post":{"operationId":"pdfMerge","tags":["PDF"],"summary":"Merge PDFs","description":"Merges multiple PDFs into one output PDF.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","fileName","contentType","pageCount","fileContentBase64","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"fileName":"merged.pdf","contentType":"application/pdf","pageCount":8,"fileContentBase64":"<base64_pdf>","warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"}},"required":["fileName","fileContentBase64"],"additionalProperties":false},"title":"Files","x-ms-summary":"Files"},"outputFileName":{"type":"string","title":"Output File Name","x-ms-summary":"Output File Name"}},"required":["files","outputFileName"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"files":[{"fileName":"a.pdf","fileContentBase64":"<base64_pdf>"},{"fileName":"b.pdf","fileContentBase64":"<base64_pdf>"}],"outputFileName":"merged.pdf"}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/split":{"post":{"operationId":"pdfSplit","tags":["PDF"],"summary":"Split PDF","description":"Splits PDF by mode/pages/ranges.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"originalFileName":{"type":"string","title":"Original File Name","x-ms-summary":"Original File Name"},"mode":{"type":"string","title":"Mode","x-ms-summary":"Mode"},"outputFormat":{"type":"string","title":"Output Format","x-ms-summary":"Output Format"},"totalPages":{"type":"number","title":"Total Pages","x-ms-summary":"Total Pages"},"outputCount":{"type":"number","title":"Output Count","x-ms-summary":"Output Count"},"files":{"type":"array","items":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"pageStart":{"type":"number","title":"Page Start","x-ms-summary":"Page Start"},"pageEnd":{"type":"number","title":"Page End","x-ms-summary":"Page End"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content"}},"required":["fileName","contentType","pageStart","pageEnd","pageCount","fileContentBase64"],"additionalProperties":false},"title":"Files","x-ms-summary":"Files"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","originalFileName","mode","outputFormat","totalPages","outputCount","files","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"originalFileName":"sample.pdf","mode":"every_page","outputFormat":"files","totalPages":3,"outputCount":3,"files":[{"fileName":"sample.page-1.pdf","contentType":"application/pdf","pageStart":1,"pageEnd":1,"pageCount":1,"fileContentBase64":"<base64_pdf>"}],"warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"},"mode":{"type":"string","title":"Mode","x-ms-summary":"Mode"},"outputFormat":{"type":"string","title":"Output Format","x-ms-summary":"Output Format"}},"required":["fileName","fileContentBase64","mode","outputFormat"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","mode":"every_page","outputFormat":"files"}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/extract-text":{"post":{"operationId":"pdfExtractText","tags":["PDF"],"summary":"Extract text","description":"Extracts text from PDF in joined or per_page mode.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"originalFileName":{"type":"string","title":"Original File Name","x-ms-summary":"Original File Name"},"pageMode":{"type":"string","title":"Page Mode","x-ms-summary":"Page Mode"},"totalPages":{"type":"number","title":"Total Pages","x-ms-summary":"Total Pages"},"text":{"type":"string","title":"Text","x-ms-summary":"Text"},"pages":{"type":"array","items":{"type":"object","properties":{"page":{"type":"number","title":"Page","x-ms-summary":"Page"},"text":{"type":"string","title":"Text","x-ms-summary":"Text"}},"required":["page","text"],"additionalProperties":false},"title":"Pages","x-ms-summary":"Pages"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","originalFileName","pageMode","totalPages","text","pages","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"originalFileName":"sample.pdf","pageMode":"joined","totalPages":2,"text":"Invoice #1001\nTotal: 120 USD","pages":[{"page":1,"text":"Invoice #1001\nTotal: 120 USD"}],"warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"},"pageMode":{"type":"string","title":"Page Mode","x-ms-summary":"Page Mode"}},"required":["fileName","fileContentBase64","pageMode"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","pageMode":"joined"}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/to-images":{"post":{"operationId":"pdfToImages","tags":["PDF"],"summary":"Render PDF to images","description":"Renders selected PDF pages to images.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"originalFileName":{"type":"string","title":"Original File Name","x-ms-summary":"Original File Name"},"format":{"type":"string","title":"Format","x-ms-summary":"Format"},"dpi":{"type":"number","title":"Dpi","x-ms-summary":"Dpi"},"outputFormat":{"type":"string","title":"Output Format","x-ms-summary":"Output Format"},"totalPages":{"type":"number","title":"Total Pages","x-ms-summary":"Total Pages"},"outputCount":{"type":"number","title":"Output Count","x-ms-summary":"Output Count"},"images":{"type":"array","items":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"page":{"type":"number","title":"Page","x-ms-summary":"Page"},"width":{"type":"number","title":"Width","x-ms-summary":"Width"},"height":{"type":"number","title":"Height","x-ms-summary":"Height"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content"}},"required":["fileName","contentType","page","width","height","fileContentBase64"],"additionalProperties":false},"title":"Images","x-ms-summary":"Images"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","originalFileName","format","dpi","outputFormat","totalPages","outputCount","images","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"originalFileName":"sample.pdf","format":"png","dpi":144,"outputFormat":"files","totalPages":3,"outputCount":2,"images":[{"fileName":"sample.page-1.png","contentType":"image/png","page":1,"width":1240,"height":1754,"fileContentBase64":"<base64_png>"}],"warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"},"format":{"type":"string","title":"Format","x-ms-summary":"Format"},"dpi":{"type":"number","title":"Dpi","x-ms-summary":"Dpi"},"pages":{"type":"string","title":"Pages","x-ms-summary":"Pages"},"outputFormat":{"type":"string","title":"Output Format","x-ms-summary":"Output Format"}},"required":["fileName","fileContentBase64","format","dpi","pages","outputFormat"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","format":"png","dpi":144,"pages":"1,3","outputFormat":"files"}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/page-numbers":{"post":{"operationId":"pdfPageNumbers","tags":["PDF"],"summary":"Add page numbers","description":"Adds page numbers to PDF pages.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"startNumber":{"type":"number","title":"Start Number","x-ms-summary":"Start Number"},"position":{"type":"string","title":"Position","x-ms-summary":"Position"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","fileName","contentType","pageCount","startNumber","position","fileContentBase64","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"fileName":"sample.numbered.pdf","contentType":"application/pdf","pageCount":4,"startNumber":1,"position":"bottom-right","fileContentBase64":"<base64_pdf>","warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"},"startNumber":{"type":"number","title":"Start Number","x-ms-summary":"Start Number"},"position":{"type":"string","title":"Position","x-ms-summary":"Position"}},"required":["fileName","fileContentBase64","startNumber","position"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","startNumber":1,"position":"bottom-right"}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/extract-metadata":{"post":{"operationId":"pdfExtractMetadata","tags":["PDF"],"summary":"Extract metadata","description":"Reads metadata from PDF.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"originalFileName":{"type":"string","title":"Original File Name","x-ms-summary":"Original File Name"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"metadata":{"type":"object","properties":{"title":{"type":"string","title":"Title","x-ms-summary":"Title"},"author":{"type":"string","title":"Author","x-ms-summary":"Author"},"subject":{"type":"string","title":"Subject","x-ms-summary":"Subject"},"keywords":{"type":"array","items":{"type":"string"},"title":"Keywords","x-ms-summary":"Keywords"}},"required":["title","author","subject","keywords"],"additionalProperties":false,"title":"Metadata","x-ms-summary":"Metadata"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","originalFileName","pageCount","metadata","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"originalFileName":"sample.pdf","pageCount":4,"metadata":{"title":"Demo Title","author":"MiniPDF","subject":"Sample","keywords":["demo","pdf"]},"warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"}},"required":["fileName","fileContentBase64"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>"}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/set-metadata":{"post":{"operationId":"pdfSetMetadata","tags":["PDF"],"summary":"Set metadata","description":"Updates metadata in PDF.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"metadata":{"type":"object","properties":{"title":{"type":"string","title":"Title","x-ms-summary":"Title"},"author":{"type":"string","title":"Author","x-ms-summary":"Author"}},"required":["title","author"],"additionalProperties":false,"title":"Metadata","x-ms-summary":"Metadata"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","fileName","contentType","pageCount","metadata","fileContentBase64","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"fileName":"sample.metadata.pdf","contentType":"application/pdf","pageCount":4,"metadata":{"title":"Demo Title","author":"MiniPDF"},"fileContentBase64":"<base64_pdf>","warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"},"metadata":{"type":"object","properties":{"title":{"type":"string","title":"Title","x-ms-summary":"Title"},"author":{"type":"string","title":"Author","x-ms-summary":"Author"}},"required":["title","author"],"additionalProperties":false,"title":"Metadata","x-ms-summary":"Metadata"}},"required":["fileName","fileContentBase64","metadata"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","metadata":{"title":"Demo Title","author":"MiniPDF"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/extract-pages":{"post":{"operationId":"pdfExtractPages","tags":["PDF"],"summary":"Extract pages","description":"Extracts selected pages into a new PDF.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"totalPages":{"type":"number","title":"Total Pages","x-ms-summary":"Total Pages"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"extractedPages":{"type":"array","items":{"type":"number"},"title":"Extracted Pages","x-ms-summary":"Extracted Pages"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","fileName","contentType","totalPages","pageCount","extractedPages","fileContentBase64","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"fileName":"extract-pages.pdf","contentType":"application/pdf","totalPages":5,"pageCount":2,"extractedPages":[1,3],"fileContentBase64":"<base64_pdf>","warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"},"pages":{"type":"array","items":{"type":"number"},"title":"Pages","x-ms-summary":"Pages"},"outputFileName":{"type":"string","title":"Output File Name","x-ms-summary":"Output File Name"}},"required":["fileName","fileContentBase64","pages","outputFileName"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","pages":[1,3],"outputFileName":"extract-pages.pdf"}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/delete-pages":{"post":{"operationId":"pdfDeletePages","tags":["PDF"],"summary":"Delete pages","description":"Deletes selected pages from PDF.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"totalPagesBefore":{"type":"number","title":"Total Pages Before","x-ms-summary":"Total Pages Before"},"totalPagesAfter":{"type":"number","title":"Total Pages After","x-ms-summary":"Total Pages After"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"deletedPages":{"type":"array","items":{"type":"number"},"title":"Deleted Pages","x-ms-summary":"Deleted Pages"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","fileName","contentType","totalPagesBefore","totalPagesAfter","pageCount","deletedPages","fileContentBase64","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"fileName":"sample.deleted-pages.pdf","contentType":"application/pdf","totalPagesBefore":5,"totalPagesAfter":4,"pageCount":4,"deletedPages":[2],"fileContentBase64":"<base64_pdf>","warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"},"pages":{"type":"array","items":{"type":"number"},"title":"Pages","x-ms-summary":"Pages"}},"required":["fileName","fileContentBase64","pages"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","pages":[2]}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/rotate-pages":{"post":{"operationId":"pdfRotatePages","tags":["PDF"],"summary":"Rotate pages","description":"Rotates selected pages by angle.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"angle":{"type":"number","title":"Angle","x-ms-summary":"Angle"},"rotatedPages":{"type":"array","items":{"type":"number"},"title":"Rotated Pages","x-ms-summary":"Rotated Pages"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","fileName","contentType","pageCount","angle","rotatedPages","fileContentBase64","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"fileName":"sample.rotated.pdf","contentType":"application/pdf","pageCount":4,"angle":90,"rotatedPages":[1,2],"fileContentBase64":"<base64_pdf>","warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"},"angle":{"type":"number","title":"Angle","x-ms-summary":"Angle"},"pages":{"type":"array","items":{"type":"number"},"title":"Pages","x-ms-summary":"Pages"}},"required":["fileName","fileContentBase64","angle","pages"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","angle":90,"pages":[1,2]}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/fill-form":{"post":{"operationId":"pdfFillForm","tags":["PDF"],"summary":"Fill form","description":"Fills AcroForm fields with values.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"filledFields":{"type":"array","items":{"type":"string"},"title":"Filled Fields","x-ms-summary":"Filled Fields"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","fileName","contentType","pageCount","filledFields","fileContentBase64","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"fileName":"sample.filled.pdf","contentType":"application/pdf","pageCount":1,"filledFields":["name","approved"],"fileContentBase64":"<base64_pdf>","warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"},"fields":{"type":"object","properties":{"name":{"type":"string","title":"Name","x-ms-summary":"Name"},"approved":{"type":"boolean","title":"Approved","x-ms-summary":"Approved"}},"required":["name","approved"],"additionalProperties":false,"title":"Fields","x-ms-summary":"Fields"}},"required":["fileName","fileContentBase64","fields"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","fields":{"name":"John Doe","approved":true}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/extract-form-data":{"post":{"operationId":"pdfExtractFormData","tags":["PDF"],"summary":"Extract form data","description":"Extracts fields and values from AcroForm PDF.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"originalFileName":{"type":"string","title":"Original File Name","x-ms-summary":"Original File Name"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"fieldCount":{"type":"number","title":"Field Count","x-ms-summary":"Field Count"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","title":"Name","x-ms-summary":"Name"},"type":{"type":"string","title":"Type","x-ms-summary":"Type"},"value":{"type":"string","title":"Value","x-ms-summary":"Value"}},"required":["name","type","value"],"additionalProperties":false},"title":"Fields","x-ms-summary":"Fields"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","originalFileName","pageCount","fieldCount","fields","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"originalFileName":"sample.pdf","pageCount":1,"fieldCount":3,"fields":[{"name":"fullName","type":"text","value":"John Doe"},{"name":"approved","type":"checkbox","value":true},{"name":"role","type":"dropdown","value":"Manager","options":["Manager","Reviewer"]}],"warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"}},"required":["fileName","fileContentBase64"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>"}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/flatten-fields":{"post":{"operationId":"pdfFlattenFields","tags":["PDF"],"summary":"Flatten form fields","description":"Flattens form fields into static content.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"flattenedFields":{"type":"number","title":"Flattened Fields","x-ms-summary":"Flattened Fields"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","fileName","contentType","pageCount","flattenedFields","fileContentBase64","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"fileName":"flattened.pdf","contentType":"application/pdf","pageCount":1,"flattenedFields":3,"fileContentBase64":"<base64_pdf>","warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"},"outputFileName":{"type":"string","title":"Output File Name","x-ms-summary":"Output File Name"}},"required":["fileName","fileContentBase64","outputFileName"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","outputFileName":"flattened.pdf"}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pdf/flatten":{"post":{"operationId":"pdfFlatten","tags":["PDF"],"summary":"Flatten alias","description":"Alias for flatten form operation.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"contentType":{"type":"string","title":"Output Content Type","x-ms-summary":"Output Content Type"},"pageCount":{"type":"number","title":"Page Count","x-ms-summary":"Page Count"},"flattenedFields":{"type":"number","title":"Flattened Fields","x-ms-summary":"Flattened Fields"},"fileContentBase64":{"type":"string","format":"byte","title":"Output File Content","x-ms-summary":"Output File Content"},"warnings":{"type":"array","items":{},"title":"Warnings","x-ms-summary":"Warnings"}},"required":["success","fileName","contentType","pageCount","flattenedFields","fileContentBase64","warnings"],"additionalProperties":false,"title":"Response","x-ms-summary":"Response"},"example":{"success":true,"fileName":"flattened.pdf","contentType":"application/pdf","pageCount":1,"flattenedFields":3,"fileContentBase64":"<base64_pdf>","warnings":[]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","title":"Success","x-ms-summary":"Success"},"error":{"type":"object","properties":{"code":{"type":"string","title":"Code","x-ms-summary":"Code"},"message":{"type":"string","title":"Message","x-ms-summary":"Message"},"details":{"type":"array","items":{},"title":"Details","x-ms-summary":"Details"}},"required":["code","message","details"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}},"required":["success","error"],"additionalProperties":false,"title":"Error","x-ms-summary":"Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","title":"File Name","x-ms-summary":"File Name"},"fileContentBase64":{"type":"string","format":"byte","title":"PDF File Content","x-ms-summary":"PDF File Content"},"outputFileName":{"type":"string","title":"Output File Name","x-ms-summary":"Output File Name"}},"required":["fileName","fileContentBase64","outputFileName"],"additionalProperties":false,"title":"Request","x-ms-summary":"Request"},"example":{"fileName":"sample.pdf","fileContentBase64":"<base64_pdf>","outputFileName":"flattened.pdf"}}}},"security":[{"ApiKeyAuth":[]}]}}}}