एक पते के रूप में साइन इन करें
अपना पासवर्ड होने से कोई व्यक्ति OpenEmail में एक पते के रूप में साइन इन कर सकता है, और केवल उसी की मेल पढ़ और भेज सकता है।
3 कॉल में से कोई भी आपके वर्कस्पेस पर चलाता है।
GET /domains/{id}/addresses/{addressId}/login
अपना पासवर्ड होने से कोई व्यक्ति OpenEmail में एक पते के रूप में साइन इन कर सकता है, और केवल उसी की मेल पढ़ और भेज सकता है।
साइन-इन पढ़ें
पासवर्ड सेट करने की तरह, members:write चाहिए। जब पते का कोई पासवर्ड नहीं होता तो login null होता है।
curl "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/login" -H "$AUTH"{ "object": "address_login", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "address": "[email protected]", "login": { "userId": "W2xR8tLq5nYc3vKp9mBd7fHs1aJe4gZu", "name": "Invoices", "createdAt": "2026-09-20T09:30:00.000Z", "createdBy": "Ana Lima", "passwordSetAt": "2026-09-28T14:05:00.000Z", "passwordSetBy": "Ana Lima", "lastSignedInAt": "2026-10-01T07:58:12.000Z" }}कुछ ख़ास पतों या डोमेनों तक सीमित कुंजी को 422 capability_unsupported के साथ मना किया जाता है, और किसी सदस्य की ओर से काम करने वाला ऐप केवल उसी पते के साइन-इन तक पहुँचता है जिस तक वह सदस्य पहुँचता है।
पासवर्ड सेट करें
members:write चाहिए। { password } के साथ PUT /domains/{id}/addresses/{addressId}/login पते को पासवर्ड देता है, या उसके मौजूदा पासवर्ड को बदल देता है। created बताता है कि साइन-इन नया है या नहीं।
curl -X PUT "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/login" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "password": "'"$INBOX_PASSWORD"'" }'{ "object": "address_login", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "address": "[email protected]", "login": { "userId": "W2xR8tLq5nYc3vKp9mBd7fHs1aJe4gZu", "name": "Invoices", "createdAt": "2026-09-20T09:30:00.000Z", "createdBy": "Ana Lima", "passwordSetAt": "2026-09-28T14:05:00.000Z", "passwordSetBy": "Ana Lima", "lastSignedInAt": "2026-10-01T07:58:12.000Z" }, "created": false}पासवर्ड में कम से कम 8 अक्षर होने चाहिए, जिनमें एक छोटा अक्षर, एक बड़ा अक्षर, एक अंक और एक विशेष चिह्न हो, वरना कॉल password पर 422 invalid_parameter होती है। OpenEmail इसे किसी को नहीं भेजता, इसलिए इसे ख़ुद सौंपें।
पासवर्ड बदलने से वे सभी साइन आउट हो जाते हैं जिन्होंने पुराने पासवर्ड से साइन इन किया था, और उनके जोड़े गए फ़ॉरवर्डिंग गंतव्य हट जाते हैं।
जिस पते के रूप में कोई OpenEmail अकाउंट पहले से साइन इन करता है उसे 409 account_exists के साथ मना किया जाता है, और बंद पते को 409 address_unavailable के साथ। जिस वर्कस्पेस के प्लान में टीम एक्सेस नहीं है, उसमें पहला पासवर्ड 403 plan_required के साथ मना किया जाता है।
कुंजी या ऐप के पास वह हर स्कोप होना चाहिए जिसे एक पते का साइन-इन इस्तेमाल कर सकता है, वरना उसे 403 insufficient_authority के साथ मना किया जाता है।
OAuth एक्सेस टोकन को इस कॉल के लिए सत्यापन कोड चाहिए। जब तक ऐप पिछले 60 मिनट में कोई कोड सत्यापित न कर ले, कॉल 403 step_up_required लौटाती है और कुछ नहीं बदलती। API कुंजी से कभी नहीं पूछा जाता। प्रमाणीकरण पेज बताता है कि कोड कैसे माँगें और सत्यापित करें।
साइन-इन हटाएँ
members:write चाहिए। DELETE /domains/{id}/addresses/{addressId}/login पासवर्ड हटा देता है और उसका इस्तेमाल करने वाले सभी को साइन आउट कर देता है। पता और उसकी मेल बनी रहती हैं।
curl -X DELETE "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/login" -H "$AUTH"{ "object": "address_login", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "address": "[email protected]", "deleted": true}बिना पासवर्ड वाले पते पर 404 मिलता है।