किसी ऑडियंस को खाली करें
एक ही ट्रांज़ैक्शन में ऑडियंस से हर संपर्क को निकालता है। ऑडियंस अपनी ID, नाम और विवरण के साथ बनी रहती है, और हर संपर्क पता-पुस्तिका में, डिफ़ॉल्ट ऑडियंस में और अपनी दूसरी ऑडियंस में बना रहता है।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
POST /audiences/{id}/empty
एक ही ट्रांज़ैक्शन में ऑडियंस से हर संपर्क को निकालता है। ऑडियंस अपनी ID, नाम और विवरण के साथ बनी रहती है, और हर संपर्क पता-पुस्तिका में, डिफ़ॉल्ट ऑडियंस में और अपनी दूसरी ऑडियंस में बना रहता है।
उदाहरण
audiences:write चाहिए। कोई बॉडी नहीं है।
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/empty" -H "$AUTH"{ "object": "audience", "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "description": "Customers who asked to hear about releases", "builtin": null, "contactCount": 0, "lastContactAt": null, "createdAt": "2026-09-18T09:10:00.000Z", "updatedAt": "2026-09-18T09:10:00.000Z", "removed": 3}जवाब ऑडियंस है जैसी वह अभी है, साथ में removed, यानी हटाई गई सदस्यताओं की संख्या। पहले से खाली ऑडियंस को खाली करने पर removed: 0 मिलता है।
इसे पूर्ववत नहीं किया जा सकता, और कहीं दर्ज नहीं होता कि सूची में कौन था। अगर आप उसे वापस चाह सकते हैं तो पहले GET /audiences/{id}/contacts पूरा पढ़ लें। ऐप सूची खाली करने से पहले व्यक्ति से पुष्टि करवाता है कि वह कौन है, और कुंजी के लिए ऐसा कोई चरण नहीं है, इसलिए audiences:write सोच-समझकर दें।
बिल्ट-इन डिफ़ॉल्ट ऑडियंस खाली नहीं की जा सकती। वह कॉल 409 audience_immutable के साथ अस्वीकार होती है।