संपर्क की फ़ोटो लगाएँ
किसी संपर्क के लिए दिखाई जाने वाली फ़ोटो अपलोड करता है और पहले वाली की जगह लेता है। बॉडी JSON नहीं, ख़ुद इमेज है, और उसका प्रकार `Content-Type` में होता है: `image/png`, `image/jpeg`, `image/webp` या `image/gif`, अधिकतम 5 MB। इसे 512 पिक्सेल के वर्ग में फ़िट करके WebP के रूप में रखा जाता है, और एनिमेटेड इमेज का पहला फ़्रेम रहता है।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
PUT /contacts/{email}/photo
किसी संपर्क के लिए दिखाई जाने वाली फ़ोटो अपलोड करता है और पहले वाली की जगह लेता है। बॉडी JSON नहीं, ख़ुद इमेज है, और उसका प्रकार Content-Type में होता है: image/png, image/jpeg, image/webp या image/gif, अधिकतम 5 MB। इसे 512 पिक्सेल के वर्ग में फ़िट करके WebP के रूप में रखा जाता है, और एनिमेटेड इमेज का पहला फ़्रेम रहता है।
उदाहरण
contacts:write चाहिए। पता सहेजा गया संपर्क होना चाहिए, इसलिए पहले उसे PUT /contacts/{email} से सहेजें।
curl -X PUT "$OE/contacts/grace%40example.com/photo" -H "$AUTH" -H 'content-type: image/jpeg' --data-binary @grace.jpg{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": null, "photoUrl": "https://cdn-prod.openemail.uk/contacts/photos/5b0e2c7a-91d4-4f3e-8a26-c4f1d9e07b3a.webp", "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-23T10:20:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" } ]}जो पता सहेजा गया संपर्क नहीं है वह 404 contact_not_found है। जो बॉडी स्वीकार किए गए प्रकार की इमेज नहीं है, 5 MB से बड़ी है या पढ़ी नहीं जा सकती, वह 422 invalid_image है।
व्यस्त इमेज सेवा 503 image_busy लौटाती है, जिसे सुरक्षित रूप से दोबारा आज़माया जा सकता है। हर अपलोड को नया photoUrl मिलता है, इसलिए कैश में रखी पुरानी फ़ोटो कभी नई की जगह नहीं दिखती।