{"openapi":"3.0.3","info":{"title":"Personal WhatsApp Gateway API","description":"Managed multi-account WhatsApp Web gateway (SaaS). Use the per-account Bearer token on `/api/v1/*` endpoints, and the admin JWT on management endpoints.","version":"1.0.0","contact":{"name":"WhatsApp Gateway"}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"wapi_...","description":"Per-account API token (Bearer)"},"adminJwt":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Admin JWT"}},"schemas":{}},"paths":{"/v1/health":{"get":{"summary":"Liveness/readiness check","tags":["Health"],"responses":{"200":{"description":"Default Response"}}}},"/v1/version":{"get":{"summary":"Running build identifier","tags":["Health"],"responses":{"200":{"description":"Default Response"}}}},"/v1/auth/login":{"post":{"summary":"Admin login","tags":["Auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","password"],"properties":{"email":{"type":"string","format":"email"},"password":{"type":"string","minLength":6}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"user":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"}}}}}}}}}}},"/v1/auth/me":{"get":{"summary":"Current user","tags":["Auth"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/auth/register":{"post":{"summary":"Public sign-up","tags":["Auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","email","password"],"properties":{"name":{"type":"string","minLength":2,"maxLength":80},"email":{"type":"string","format":"email"},"password":{"type":"string","minLength":8,"maxLength":128}}}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts":{"post":{"summary":"Create account","tags":["Accounts"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}},"get":{"summary":"List accounts","tags":["Accounts"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}":{"get":{"summary":"Get account","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"Update account","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Delete account","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/token/regenerate":{"post":{"summary":"Regenerate API token","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/connect":{"post":{"summary":"Start session / request QR","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/disconnect":{"post":{"summary":"Disconnect session","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/qr":{"get":{"summary":"Get current QR code","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/status":{"get":{"summary":"Get account status","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/tokens":{"get":{"summary":"List API tokens for an account","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Create a new API token (raw value returned once)","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/tokens/{tokenId}":{"patch":{"summary":"Rename a token or change its expiry","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"tokenId","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Delete a token permanently","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"tokenId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/tokens/{tokenId}/revoke":{"post":{"summary":"Revoke a token (instantly invalidates it)","tags":["Accounts"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"tokenId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/contacts":{"get":{"summary":"Admin: list contacts","tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/chats":{"get":{"summary":"Admin: list chats","tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/chats/{chatId}/export":{"get":{"summary":"Admin: export chat messages as .txt (oldest → newest)","tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"chatId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/chats/{chatId}/sync-history":{"post":{"summary":"Admin: request older chat history from WhatsApp","tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"chatId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/chats/{chatId}/messages":{"get":{"summary":"Admin: list messages in a chat","tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"chatId","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Admin: send a manual reply to a chat","tags":["Messages"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"chatId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/messages":{"get":{"summary":"Admin browse messages","tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/messages/send-text":{"post":{"tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/messages/send-media":{"post":{"tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/messages/send-location":{"post":{"tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/messages/queue-text":{"post":{"tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/webhook-deliveries":{"get":{"tags":["Admin"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai-logs":{"get":{"tags":["Admin"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/messages/{messageId}/media":{"get":{"summary":"Download a message media binary (image/audio/video/document/sticker)","tags":["Messages"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"messageId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/messages/{messageId}/transcribe":{"post":{"summary":"Transcribe a voice message via Whisper, debit the user wallet.","tags":["Messages","AI"],"description":"Returns the transcript text and the cents debited. 402 INSUFFICIENT_BALANCE when the wallet cannot cover the estimated cost.","security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"messageId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/webhooks":{"get":{"tags":["Webhooks"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"tags":["Webhooks"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/webhooks/{webhookId}":{"patch":{"tags":["Webhooks"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"webhookId","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"tags":["Webhooks"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"webhookId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/webhooks/{webhookId}/test":{"post":{"tags":["Webhooks"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"webhookId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/webhook-deliveries":{"get":{"tags":["Webhooks"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/webhook-deliveries/{deliveryId}/retry":{"post":{"tags":["Webhooks"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"deliveryId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/ai":{"get":{"tags":["AI"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"put":{"summary":"Create/update AI integration","tags":["AI"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"tags":["AI"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/ai/logs":{"get":{"summary":"List AI logs","tags":["AI"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/global":{"get":{"tags":["AI Integrations"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}},"put":{"tags":["AI Integrations"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/global/models":{"get":{"summary":"List available models","tags":["AI Integrations"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/global/usage/reset":{"post":{"tags":["AI Integrations"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/chat/test":{"post":{"summary":"Send a test message to the configured AI (account-scoped)","tags":["AI Chat"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/admin/test":{"post":{"summary":"Admin: send a test message to global AI","tags":["AI Chat"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/chats/{chatId}/ai":{"get":{"tags":["AI Integrations"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"chatId","required":true}],"responses":{"200":{"description":"Default Response"}}},"put":{"tags":["AI Integrations"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"chatId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/ai/diagnose":{"get":{"summary":"Diagnose AI auto-reply","tags":["AI Integrations"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/billing/webhook":{"post":{"summary":"Lemon Squeezy webhook receiver","tags":["Billing"],"description":"Verifies HMAC and updates Subscription rows.","responses":{"200":{"description":"Default Response"}}}},"/v1/billing/paddle/webhook":{"post":{"summary":"Paddle Billing webhook receiver","tags":["Billing"],"description":"Verifies HMAC of (`<ts>:<rawBody>`) and updates wallet / subscription rows.","responses":{"200":{"description":"Default Response"}}}},"/v1/billing/config":{"get":{"tags":["Billing"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/billing/accounts/{accountId}/subscription":{"get":{"tags":["Billing"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"accountId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/billing/accounts/{accountId}/checkout":{"post":{"tags":["Billing"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"accountId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/billing/accounts/{accountId}/bank-transfer":{"post":{"tags":["Billing"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"accountId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/billing/accounts/{accountId}/cancel":{"post":{"tags":["Billing"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"accountId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/billing/accounts/{accountId}/resume":{"post":{"tags":["Billing"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"accountId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/billing/accounts/{accountId}/grant-free":{"post":{"tags":["Billing"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"accountId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/billing/accounts/{accountId}/revoke-free":{"post":{"tags":["Billing"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"accountId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/billing/bank-transfer/submissions":{"get":{"tags":["Billing"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/billing/bank-transfer/submissions/{id}/review":{"post":{"tags":["Billing"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/users":{"get":{"summary":"List users","tags":["Admin"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Create user","tags":["Admin"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/users/{id}":{"get":{"summary":"Get user","tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"Update user","tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Delete user","tags":["Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/metrics":{"get":{"tags":["Admin"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/settings":{"get":{"tags":["Admin","Settings"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}},"put":{"tags":["Admin","Settings"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/settings/{key}":{"delete":{"tags":["Admin","Settings"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"key","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/anti-spam/policy":{"get":{"tags":["Anti-spam"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}},"put":{"summary":"Update global anti-spam policy","tags":["Anti-spam"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/anti-spam/users/{id}/policy":{"put":{"summary":"Override anti-spam policy for one user","tags":["Anti-spam"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"tags":["Anti-spam"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/wallet/me":{"get":{"tags":["Wallet"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/wallet/transactions":{"get":{"tags":["Wallet"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/wallet/topup":{"post":{"summary":"Start a hosted checkout for a wallet top-up","tags":["Wallet"],"description":"gateway=lemonsqueezy (default) or paddle — pick the configured provider.","security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/wallet/users/{id}":{"get":{"tags":["Wallet","Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/wallet/users/{id}/adjust":{"post":{"summary":"Admin: credit or debit a user’s wallet manually","tags":["Wallet","Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai-pricing":{"get":{"tags":["AI","Admin"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}},"put":{"tags":["AI","Admin"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai-pricing/{modelName}":{"delete":{"tags":["AI","Admin"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"modelName","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai-pricing/reapply-margin":{"post":{"summary":"Recompute every row's user-facing price from its provider cost × margin","tags":["AI","Admin"],"security":[{"adminJwt":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/exports/chats.csv":{"get":{"summary":"CSV of every chat (phone numbers + names + last activity)","tags":["Exports"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/exports/full.json":{"get":{"summary":"Full account export (chats + text messages) as JSON","tags":["Exports"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/accounts/{id}/exports/bulk-sync":{"post":{"summary":"Sync older history for every chat of an account","tags":["Exports"],"security":[{"adminJwt":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/auth/google/config":{"get":{"tags":["Auth"],"responses":{"200":{"description":"Default Response"}}}},"/v1/auth/google/start":{"get":{"summary":"Begin Google sign-in","tags":["Auth"],"responses":{"200":{"description":"Default Response"}}}},"/v1/auth/google/callback":{"get":{"summary":"Google sign-in callback","tags":["Auth"],"responses":{"200":{"description":"Default Response"}}}},"/v1/me":{"get":{"summary":"Current authenticated account (by token)","tags":["Account"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/settings":{"get":{"summary":"Get channel settings","tags":["Channel"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"Update channel settings","tags":["Channel"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Reset channel settings","tags":["Channel"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/settings/events":{"get":{"summary":"Get allowed events","tags":["Channel"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/settings/webhook_test":{"post":{"summary":"Test webhook (fires for all webhooks)","tags":["Channel"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/limits":{"get":{"summary":"Get limits","tags":["Channel"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/users/login":{"get":{"summary":"Login user with QR (data-URL PNG)","tags":["Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/users/login/image":{"get":{"summary":"Login user with QR (PNG image)","tags":["Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/users/login/rowdata":{"get":{"summary":"Login user with QR (raw string)","tags":["Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/users/login/{PhoneNumber}":{"get":{"summary":"Pair via phone-number pairing code (limited)","tags":["Users"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"PhoneNumber","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/users/logout":{"post":{"summary":"Logout user","tags":["Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/users/profile":{"get":{"summary":"User info","tags":["Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"Update user info","tags":["Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/status":{"put":{"summary":"Change status text","tags":["Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/text":{"post":{"summary":"💬 Send text message","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/read":{"post":{"summary":"Mark messages as read (batch)","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/reaction":{"post":{"summary":"React to message (POST alias)","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/media":{"post":{"summary":"Send media (legacy {type,url})","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/chats":{"get":{"summary":"Get chats","tags":["Chats"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/chats/{ChatID}/messages":{"get":{"summary":"Get messages in chat","tags":["Chats"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ChatID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/list":{"get":{"summary":"List messages","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/list/{ChatID}":{"get":{"summary":"List messages by chat id","tags":["Messages"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ChatID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/image":{"post":{"summary":"💬 Send image","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/video":{"post":{"summary":"Send video","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/short":{"post":{"summary":"Send PTV short","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/gif":{"post":{"summary":"Send animated gif","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/audio":{"post":{"summary":"Send audio","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/voice":{"post":{"summary":"Send voice (PTT)","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/document":{"post":{"summary":"Send document","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/sticker":{"post":{"summary":"Send sticker","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/media/{MediaMessageType}":{"post":{"summary":"Generic media send","tags":["Messages"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MediaMessageType","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/link_preview":{"post":{"summary":"Send link with preview","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/location":{"post":{"summary":"Send location","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/live_location":{"post":{"summary":"Send live location","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/contact":{"post":{"summary":"Send contact card","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/contact_list":{"post":{"summary":"Send contact list","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/poll":{"post":{"summary":"Send poll","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/interactive":{"post":{"summary":"Send interactive (buttons/list)","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/carousel":{"post":{"summary":"Send carousel","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/story":{"post":{"summary":"Send story (legacy alias)","tags":["Stories"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/story/text":{"post":{"summary":"Post text story","tags":["Stories"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/story/media":{"post":{"summary":"Post media story","tags":["Stories"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/story/audio":{"post":{"summary":"Post audio story","tags":["Stories"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/{MessageID}":{"get":{"summary":"Get message","tags":["Messages"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Forward message","tags":["Messages"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}},"put":{"summary":"Mark as read","tags":["Messages"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Delete message","tags":["Messages"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/{MessageID}/reaction":{"put":{"summary":"React to message","tags":["Messages"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Remove reaction","tags":["Messages"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/{MessageID}/star":{"put":{"summary":"Star message","tags":["Messages"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/{MessageID}/pin":{"post":{"summary":"Pin message","tags":["Messages"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Unpin message","tags":["Messages"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages/event":{"post":{"summary":"Send event message","tags":["Messages"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/chats/{ChatID}":{"get":{"summary":"Get chat","tags":["Chats"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ChatID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Delete chat (local + remote)","tags":["Chats"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ChatID","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Archive/Unarchive chat","tags":["Chats"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ChatID","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"Pin/Mute/Read/Disappearing","tags":["Chats"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ChatID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/contacts":{"get":{"summary":"Get contacts","tags":["Contacts"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Check phones","tags":["Contacts"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"put":{"summary":"Add contact","tags":["Contacts"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/contacts/{ContactID}":{"get":{"summary":"Get / check contact","tags":["Contacts"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}},"head":{"summary":"Get / check contact","tags":["Contacts"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Send contact card (alias)","tags":["Contacts"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"Edit contact","tags":["Contacts"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Delete contact","tags":["Contacts"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/contacts/{ContactID}/profile":{"get":{"summary":"Get profile (picture + status)","tags":["Contacts"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/contacts/lids":{"get":{"summary":"Get LIDs by IDs","tags":["Contacts"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/contacts/lids/{ContactID}":{"get":{"summary":"Get LID by ID","tags":["Contacts"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/presences/me":{"put":{"summary":"Send online/offline presence","tags":["Presences"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/presences/{EntryID}":{"get":{"summary":"Get presence","tags":["Presences"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"EntryID","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Subscribe to presence","tags":["Presences"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"EntryID","required":true}],"responses":{"200":{"description":"Default Response"}}},"put":{"summary":"Send typing/recording","tags":["Presences"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"EntryID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/groups":{"get":{"summary":"Get groups","tags":["Groups"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Create group","tags":["Groups"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"put":{"summary":"Accept group invite","tags":["Groups"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/groups/{GroupID}":{"get":{"summary":"Get group","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}},"put":{"summary":"Update group info","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Leave group","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"Group setting (announce/locked/eph)","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/groups/{GroupID}/invite":{"get":{"summary":"Get group invite code","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Revoke group invite","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/groups/{GroupID}/participants":{"post":{"summary":"Add participants","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Remove participants","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/groups/{GroupID}/admins":{"patch":{"summary":"Promote to admin","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Demote admin","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/groups/{GroupID}/icon":{"get":{"summary":"Get group icon","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}},"put":{"summary":"Set group icon","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Delete group icon","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/groups/link/{InviteCode}":{"get":{"summary":"Get group info by invite code","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"InviteCode","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Send group invite link","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"InviteCode","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/groups/{GroupID}/applications":{"get":{"summary":"List join requests","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Approve join requests","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Reject join requests","tags":["Groups"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/stories":{"get":{"summary":"Get list of stories","tags":["Stories"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Create story","tags":["Stories"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/stories/send/text":{"post":{"summary":"Post text story","tags":["Stories"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/stories/send/media":{"post":{"summary":"Post media story","tags":["Stories"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/stories/send/audio":{"post":{"summary":"Post audio story","tags":["Stories"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/stories/{MessageID}":{"get":{"summary":"Get story","tags":["Stories"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}},"put":{"summary":"Copy story","tags":["Stories"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/statuses/{MessageID}":{"get":{"summary":"Get view statuses","tags":["Statuses"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MessageID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/newsletters":{"get":{"summary":"List subscribed newsletters","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Create newsletter","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/newsletters/find":{"get":{"summary":"Find newsletters","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/newsletters/recommended":{"get":{"summary":"Recommended newsletters","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/newsletters/{NewsletterID}":{"get":{"summary":"Get newsletter","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Delete newsletter","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterID","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"Edit newsletter","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/newsletters/{NewsletterID}/subscription":{"post":{"summary":"Subscribe","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Unsubscribe","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/newsletters/invite/{NewsletterInviteCode}/subscription":{"post":{"summary":"Subscribe by invite","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterInviteCode","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Unsubscribe by invite","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterInviteCode","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/newsletters/{NewsletterID}/tracking":{"post":{"summary":"Subscribe to updates","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/newsletters/{NewsletterID}/messages":{"get":{"summary":"Newsletter messages","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/newsletters/{NewsletterID}/invite/{ContactID}":{"post":{"summary":"Create admin invite","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterID","required":true},{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Revoke admin invite","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterID","required":true},{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/newsletters/{NewsletterID}/admins/{ContactID}":{"put":{"summary":"Accept admin request","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterID","required":true},{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Demote admin","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterID","required":true},{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/newsletters/link/{NewsletterInviteCode}":{"post":{"summary":"Send invite link","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterInviteCode","required":true}],"responses":{"200":{"description":"Default Response"}}},"get":{"summary":"Info by invite","tags":["Newsletters"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"NewsletterInviteCode","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/media":{"get":{"summary":"List media files","tags":["Media"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Upload media (multipart or base64)","tags":["Media"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/media/{MediaID}":{"get":{"summary":"Get media file","tags":["Media"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MediaID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Delete media file","tags":["Media"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"MediaID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/business":{"get":{"summary":"GET /business","tags":["Business"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"POST /business","tags":["Business"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/business/products":{"get":{"summary":"GET /business/products","tags":["Business"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"POST /business/products","tags":["Business"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/business/{ContactID}/products":{"get":{"summary":"GET /business/:ContactID/products","tags":["Business"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/business/products/{ProductID}":{"get":{"summary":"GET /business/products/:ProductID","tags":["Business"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ProductID","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"POST /business/products/:ProductID","tags":["Business"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ProductID","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"PATCH /business/products/:ProductID","tags":["Business"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ProductID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"DELETE /business/products/:ProductID","tags":["Business"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ProductID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/business/orders/{OrderID}":{"get":{"summary":"GET /business/orders/:OrderID","tags":["Business"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"OrderID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/business/catalogs/{ContactID}":{"post":{"summary":"POST /business/catalogs/:ContactID","tags":["Business"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/business/collections":{"post":{"summary":"POST /business/collections","tags":["Business"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"get":{"summary":"GET /business/collections","tags":["Business"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/business/collections/products":{"get":{"summary":"GET /business/collections/products","tags":["Business"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/business/collections/{CollectionID}":{"get":{"summary":"GET /business/collections/:CollectionID","tags":["Business"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CollectionID","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"PATCH /business/collections/:CollectionID","tags":["Business"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CollectionID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"DELETE /business/collections/:CollectionID","tags":["Business"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CollectionID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/business/collections/{CollectionID}/products":{"get":{"summary":"GET /business/collections/:CollectionID/products","tags":["Business"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CollectionID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/labels":{"get":{"summary":"Get labels","tags":["Labels"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Create label","tags":["Labels"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/labels/{LabelID}":{"get":{"summary":"Get label associations","tags":["Labels"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"LabelID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/labels/{LabelID}/{AssociationID}":{"post":{"summary":"Add association","tags":["Labels"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"LabelID","required":true},{"schema":{"type":"string"},"in":"path","name":"AssociationID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Remove association","tags":["Labels"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"LabelID","required":true},{"schema":{"type":"string"},"in":"path","name":"AssociationID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/blacklist":{"get":{"summary":"Get blacklist (blocked contacts)","tags":["Blacklist"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/blacklist/{ContactID}":{"put":{"summary":"Block contact","tags":["Blacklist"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Unblock contact","tags":["Blacklist"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"ContactID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/communities":{"get":{"summary":"GET /communities","tags":["Communities"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"POST /communities","tags":["Communities"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/communities/{CommunityID}":{"get":{"summary":"GET /communities/:CommunityID","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"POST /communities/:CommunityID","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"DELETE /communities/:CommunityID","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/communities/{CommunityID}/link":{"delete":{"summary":"DELETE /communities/:CommunityID/link","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/communities/{CommunityID}/{GroupID}":{"put":{"summary":"PUT /communities/:CommunityID/:GroupID","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true},{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"DELETE /communities/:CommunityID/:GroupID","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true},{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/communities/{CommunityID}/{GroupID}/join":{"post":{"summary":"POST /communities/:CommunityID/:GroupID/join","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true},{"schema":{"type":"string"},"in":"path","name":"GroupID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/communities/{CommunityID}/settings":{"patch":{"summary":"PATCH /communities/:CommunityID/settings","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/communities/{CommunityID}/participants":{"post":{"summary":"POST /communities/:CommunityID/participants","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"DELETE /communities/:CommunityID/participants","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/communities/{CommunityID}/admins":{"patch":{"summary":"PATCH /communities/:CommunityID/admins","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"DELETE /communities/:CommunityID/admins","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/communities/{CommunityID}/subgroups":{"get":{"summary":"GET /communities/:CommunityID/subgroups","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/communities/event":{"post":{"summary":"POST /communities/event","tags":["Communities"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/communities/{CommunityID}/createGroup":{"post":{"summary":"POST /communities/:CommunityID/createGroup","tags":["Communities"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CommunityID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/calls":{"post":{"summary":"Create call (stub)","tags":["Calls"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/calls/{CallID}":{"delete":{"summary":"Reject call","tags":["Calls"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CallID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/calls/{CallID}/reject":{"post":{"summary":"Reject call (alias)","tags":["Calls"],"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"CallID","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/calls/group_link":{"post":{"summary":"Create group call link","tags":["Calls"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response"}}}}},"servers":[{"url":"https://wapi.aramin.co/api","description":"Public API"}],"tags":[{"name":"Health","description":"Liveness / readiness"},{"name":"Auth","description":"Admin login & current user"},{"name":"Accounts","description":"WhatsApp account management"},{"name":"WhatsApp Sessions","description":"QR login, connect, disconnect"},{"name":"Messages","description":"Send and inspect messages"},{"name":"Chats","description":"Chats listing and details"},{"name":"Contacts","description":"Contact lookups"},{"name":"Groups","description":"Group metadata"},{"name":"Channels","description":"Newsletter / channel data (limited support)"},{"name":"Webhooks","description":"Webhook registration and deliveries"},{"name":"AI Integrations","description":"AI settings, global and per-account"},{"name":"AI Chat","description":"Interactive AI testing / single completions"},{"name":"Admin","description":"Cross-account admin browsing endpoints"}]}