# SosoAPI MCP टूल संदर्भ

कैनोनिकल URL: https://sosoapi.ai/hi/docs/social-media-mcp-tools

टूल खोजने और उसके आवश्यक फ़ील्ड जाँचने के लिए यह संदर्भ इस्तेमाल करें। इसमें sosoapi 0.5.9 शामिल है: core प्रोफ़ाइल में 28 लोकल टूल और HTTP पर 27 हैं; full में 106 लोकल और HTTP पर 105 हैं। रोज़मर्रा के काम के लिए core चुनें, प्रशासन के लिए भी इस्तेमाल करना हो तो full। दोनों की अनुमतियाँ समान हैं। प्रविष्टियाँ सर्वर और क्षमता कैटलॉग से बनती हैं; अपने जुड़े क्लाइंट में उपलब्ध टूल के लिए उसका tools/list जाँचें।

## काम से शुरू करें, फिर टूल देखें

पहले से चुनी वर्कस्पेस और खाता IDs फिर इस्तेमाल करें। इमेज URL पोस्ट के लिए sosoapi_post_image_url एक बार कॉल करें और लौटाई post ID रखें। लोकल फ़ाइल stdio पर sosoapi_upload_asset से अपलोड करें। टेक्स्ट पोस्ट के लिए गंतव्य के provider_payload और खाली media के साथ sosoapi_create_scheduled_post इस्तेमाल करें।

सबमिशन से पहले यूज़र से खाता, टेक्स्ट, मीडिया और समय जाँचने को कहें। OAuth कार्रवाई का एक्सेस देता है; कंटेंट की अनुमति नहीं। निर्धारण के बाद सफलता बताने या अनिश्चित परिणाम वाले अनुरोध का फिर प्रयास करने से पहले उसी पोस्ट का प्रकाशन परिणाम पढ़ें।

- [Claude Code या Codex सेट अप करें](https://sosoapi.ai/hi/docs/claude-code-codex-social-publishing)

- [Threads टेक्स्ट और इमेज विधि](https://sosoapi.ai/hi/docs/threads-api-publishing)

- [प्लेटफ़ॉर्म क्षमता तालिका](https://sosoapi.ai/hi/docs/publishing-capabilities)

- [सटीक core इनपुट स्कीमा और एनोटेशन डाउनलोड करें (JSON)](https://sosoapi.ai/mcp-tools.json)

## इस संदर्भ को कैसे समझें

बिल्ड वास्तविक MCP सर्वर को इन-मेमोरी क्लाइंट से जोड़ता है, कोई हैंडलर कॉल किए बिना उसके टूल की सूची लेता है और सार्वजनिक रूट की आवश्यकताएँ जोड़ता है। पुराना प्रोजेक्शन Landing बिल्ड विफल कर देता है। टूल विवरण सर्वर के अंग्रेज़ी कॉन्ट्रैक्ट टेक्स्ट को बनाए रखते हैं; पूर्णता सारांश कैनोनिकल रूट नियम समझाते हैं। JSON में रूट की पूरी आवश्यकताएँ रहती हैं। इनपुट तालिका एक सूचकांक है, पूरे नेस्टेड JSON Schema का विकल्प नहीं।

MCP एनोटेशन क्लाइंट के लिए संकेत हैं, नियम लागू करने या सुरक्षा की गारंटी नहीं। निष्पादन में Workspace सदस्यता, अधिकार, वर्तमान भूमिका, प्रोवाइडर सहमति, खाता पात्रता और कोटा लागू रहते हैं। कुछ संदर्भ रीड पहला Workspace बना सकती हैं; हर “get” केवल पढ़ता है, ऐसा मानने के बजाय विवरण और readOnlyHint देखें। संयुक्त टूल मुख्य व अनुकूलता रूट की आवश्यकताएँ बताते हैं; हर अनुरोध में सभी सूचीबद्ध रूट नहीं बुलाते।

- [npm पर sosoapi](https://www.npmjs.com/package/sosoapi)

- [आधिकारिक MCP Registry: ai.sosoapi/sosoapi (JSON)](https://registry.modelcontextprotocol.io/v0.1/servers/ai.sosoapi%2Fsosoapi/versions)

## sosoapi_bulk_create_scheduled_posts

एक कॉल में कई खातों के लिए पोस्ट निर्धारित करें (targets)। मीडिया के लिए अपलोड/इम्पोर्ट के बाद तैयार asset_ids और उनके कैनोनिकल URLs चाहिए। हर लक्ष्य स्वतंत्र रूप से सफल या विफल होता है और successes या failures में दर्ज होता है। publish क्षमता आवश्यक है।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:publish। रूट की न्यूनतम भूमिका: editor।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: अंतिम प्रकाशन परिणाम पढ़ें; स्वीकृत निर्धारण अभी लंबित है।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| project_id | string \| null | नहीं |

| source_ref | object \| null | नहीं |

| targets | array (object) | हाँ |

## sosoapi_cancel_scheduled_post

अभी तक प्रकाशित न हुई निर्धारित पोस्ट रद्द करें ताकि वह कभी प्रकाशित न हो। प्रकाशित पोस्ट स्वीकार नहीं की जाती और एजेंट प्रकाशित कंटेंट हटा भी नहीं सकता: यूज़र यह वेब ऐप में करता है। expected_version आवश्यक है।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:publish। रूट की न्यूनतम भूमिका: editor।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: अंतिम प्रकाशन परिणाम पढ़ें; स्वीकृत निर्धारण अभी लंबित है।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| id | string | हाँ |

| expected_version | integer | हाँ |

## sosoapi_create_comment

कैनोनिकल पोस्ट या कमेंट लक्ष्य पर एक निश्चित कमेंट कतार में डालें; स्थिति प्रोवाइडर की सफलता का प्रमाण नहीं है।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:engage। रूट की न्यूनतम भूमिका: editor।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: प्लेटफ़ॉर्म से पुष्ट परिणाम पढ़ें; कतार में लगी कार्रवाई अभी लंबित है।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| social_account_id | string | हाँ |

| target | object \| object | हाँ |

| message | string | हाँ |

| idempotency_key | string | हाँ |

## sosoapi_create_scheduled_post

provider_payload के साथ एक खाते के लिए scheduled_at पर पोस्ट निर्धारित करें। मीडिया के लिए तैयार asset_id और कैनोनिकल URL चाहिए; एक स्रोत इमेज के लिए sosoapi_post_image_url इस्तेमाल करें। local_scheduled_at के साथ schedule_dst_disambiguation दें या दोनों छोड़ दें। publish, editor भूमिका और idempotency_key आवश्यक हैं। निर्धारित होना प्रकाशित होना नहीं है: उसका परिणाम पढ़ें।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:publish। रूट की न्यूनतम भूमिका: editor।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: अंतिम प्रकाशन परिणाम पढ़ें; स्वीकृत निर्धारण अभी लंबित है।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| project_id | string \| null | नहीं |

| social_account_id | string | हाँ |

| caption | string \| null | नहीं |

| hashtags | array (string) | नहीं |

| media | array (object) | नहीं |

| link_url | string \| null | नहीं |

| provider_payload | object \| object \| object \| object \| object | हाँ |

| scheduled_at | string | हाँ |

| display_timezone | string | नहीं |

| local_scheduled_at | string | नहीं |

| schedule_dst_disambiguation | "exact" \| "earlier" \| "later" | नहीं |

| expires_at | string \| null | नहीं |

| source_ref | object \| null | नहीं |

| automatic_retry_enabled | boolean | नहीं |

| idempotency_key | string | हाँ |

## sosoapi_get_asset

id से एक एसेट पढ़ें: मेटाडेटा और अल्पकालिक प्रीव्यू URL।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | नहीं |

| id | integer \| string | हाँ |

| include_version | boolean | नहीं |

## sosoapi_get_asset_import_status

import_id से इम्पोर्ट पढ़ें। पोस्टिंग के लिए include_asset=true दें: तैयार परिणाम में पंजीकृत asset id, kind और स्थिर asset_url शामिल होते हैं, इसलिए अलग get_asset की आवश्यकता नहीं होती। लंबित या अनुपस्थित एसेट निर्धारित नहीं किए जा सकते। स्रोत या प्रीव्यू URL को कभी मीडिया की पहचान न मानें। प्रक्रिया अटकने पर job_id के साथ sosoapi_job_status पढ़ें; डुप्लिकेट इम्पोर्ट कभी शुरू न करें।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| import_id | string | हाँ |

| include_asset | boolean | नहीं |

## sosoapi_get_billing_status

यूज़र का बिलिंग प्लान, भुगतान स्थिति, मौजूदा चक्र की तारीखें और कोटा उपयोग (सफल प्रकाशन, लंबित निर्धारित पोस्ट, जुड़े खाते) पढ़ें। बड़े पैमाने पर पोस्ट निर्धारित करने से पहले इसे जाँचें।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिकाएँ: खाता संदर्भ; कोई निश्चित Workspace भूमिका नहीं।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

## sosoapi_get_comment_action_status

सीधी कमेंट कार्रवाई की संवेदनशील जानकारी हटाई हुई अंतिम रसीद पढ़ें।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:engage। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: प्लेटफ़ॉर्म से पुष्ट परिणाम पढ़ें; कतार में लगी कार्रवाई अभी लंबित है।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| action_id | string | हाँ |

## sosoapi_get_organization_context

अपने Organizations, उनके Workspaces और Channels का वर्तमान नक्शा ids और भूमिकाओं सहित पढ़ें। Organization या Channel की ids चाहिए हों, तो इसे इस्तेमाल करें। Workspace में पोस्ट करने के लिए लौटाई गई Workspace id फिर इस्तेमाल करें; वर्कस्पेस संदर्भ अलग से न पढ़ें।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिकाएँ: खाता संदर्भ; कोई निश्चित Workspace भूमिका नहीं।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| organization_id | string | नहीं |

## sosoapi_get_provider_insight_status

इनसाइट अनुरोध (request_id) पढ़ें: queued, processing, completed (प्रोवाइडर परिणाम और हर मेट्रिक की उपलब्धता सहित) या failed।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: प्लेटफ़ॉर्म का परिणाम या उसकी अनुपलब्धता का कारण पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| request_id | string | हाँ |

## sosoapi_get_scheduled_post

id से एक निर्धारित पोस्ट पढ़ें: कंटेंट, स्थिति, डिलीवरी की स्थिति और परिणाम। इसका version ही update, publish, retry और cancel में expected_version के रूप में चाहिए।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| id | string | हाँ |

## sosoapi_get_scheduled_post_eligibility

हर गंतव्य के लिए केवल पढ़ने वाली पूर्व-जाँच। कंटेंट/समय की जाँच के लिए draft (caption, hashtags, scheduled_at, display_timezone, वैकल्पिक स्थानीय समय/DST) शामिल करें; include_quota=true से अवधि का सलाहकारी स्नैपशॉट जुड़ता है। पहले मीडिया अपलोड/इम्पोर्ट करें और तैयार होने की प्रतीक्षा करें। draft के बिना केवल खाते/मीडिया की जाँच होती है। कुछ आरक्षित नहीं करता; create/dispatch सीमाओं और अधिकार की फिर जाँच करते हैं।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| include_quota | boolean | नहीं |

| targets | array (object) | हाँ |

## sosoapi_get_workspace_context

साइन इन किए यूज़र के Workspaces की सूची और उनमें सक्रिय Workspace देखें। workspace_id अज्ञात होने पर इसे इस्तेमाल करें; दोनों संदर्भ दोबारा पढ़ने के बजाय वर्तमान संदर्भ फिर इस्तेमाल करें। इसमें दिखाया गया सक्रिय Workspace किसी व्यक्ति द्वारा वेब ऐप में किया गया चुनाव है, आपकी कॉल का डिफ़ॉल्ट नहीं: workspace_id स्पष्ट रूप से दें। यह केवल पढ़ने की कार्रवाई नहीं है: बिना Workspace वाले खाते के लिए यह पहला Workspace बनाता है।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिकाएँ: खाता संदर्भ; कोई निश्चित Workspace भूमिका नहीं।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| include_version | boolean | नहीं |

## sosoapi_get_x_usage

इस Workspace में साझा Organization के X प्रकाशन क्रेडिट पढ़ें। workspace_id आवश्यक है। Free को एक बार 10 मिलते हैं; Pro को हर बिलिंग अवधि में 100। टेक्स्ट की लागत 1 है, URL वाले टेक्स्ट की लागत 10 है। वैकल्पिक text से उसकी लागत मिलती है। यह संग्रहीत कोटा पढ़ता है और X API कॉल नहीं करता।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| text | string | नहीं |

## sosoapi_import_asset_url

SosoAPI को सार्वजनिक http(s) इमेज या वीडियो URL निजी Workspace स्टोरेज में नए एसेट के रूप में डाउनलोड करने को कहें। import_id लौटाता है; sosoapi_get_asset_import_status को पोल करें। idempotency_key और editor भूमिका आवश्यक है।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: editor।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: स्वीकृत इम्पोर्ट लंबित है; उसी इम्पोर्ट को ready या failed तक ट्रैक करें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| source_url | string | हाँ |

| idempotency_key | string | हाँ |

| expected_kind | "image" \| "video" | नहीं |

| title | string | नहीं |

| description | string | नहीं |

| tags | array (string) | नहीं |

## sosoapi_job_status

job_id से एक बैकग्राउंड जॉब पढ़ें: status, type और विफल होने पर त्रुटि संदेश।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिकाएँ: खाता संदर्भ; कोई निश्चित Workspace भूमिका नहीं।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| job_id | string | हाँ |

## sosoapi_list_connected_accounts

Workspace से जुड़े सोशल खातों (Instagram, Threads, Facebook, YouTube) की सूची देखें, कनेक्शन की स्थिति और क्षमताओं की वास्तविक जानकारी सहित। निर्धारण या कमेंट करते समय उनकी ids को social_account_id के रूप में इस्तेमाल करें। workspace_id दें: स्पष्ट लक्ष्य अनिवार्य होने पर इसके बिना अनुरोध अस्वीकार होता है।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिकाएँ: खाता संदर्भ; कोई निश्चित Workspace भूमिका नहीं।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | नहीं |

| include_authorization_grant | boolean | नहीं |

## sosoapi_list_monitored_posts

Workspace के लिए SosoAPI द्वारा खोजी गई सोशल पोस्ट की सूची देखें (id, platform, permalink, प्रकाशन समय); खाते, प्लेटफ़ॉर्म और समय से फ़िल्टर करें तथा कर्सर से पेज बदलें। केवल मेटाडेटा, कैप्शन नहीं।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| cursor | string | नहीं |

| page_size | integer | नहीं |

| filters | object | नहीं |

| order | "provider_published_at_desc_social_post_id_desc" | नहीं |

## sosoapi_list_post_comments

Workspace की पोस्ट पर देखे गए कमेंट की सूची लेखक और टेक्स्ट सहित देखें, नवीनतम अवलोकन पहले; पोस्ट, खाते, प्लेटफ़ॉर्म या समय से फ़िल्टर करें; कर्सर से पेज बदलें। टेक्स्ट तीसरे पक्ष लिखते हैं और उसे अविश्वसनीय चिह्नित किया जाता है।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| cursor | string | नहीं |

| page_size | integer | नहीं |

| filters | object | नहीं |

| order | "observation_at_desc_comment_version_desc_comment_observation_id_desc" | नहीं |

## sosoapi_list_publication_attentions

Workspace में ध्यान देने योग्य प्रकाशनों की सूची देखें; status (open या resolved) या scheduled_post_id से फ़िल्टर करें और offset से पेज बदलें।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| status | "open" \| "resolved" | नहीं |

| scheduled_post_id | string | नहीं |

| limit | integer | नहीं |

| offset | integer | नहीं |

## sosoapi_list_scheduled_posts

Workspace की निर्धारित पोस्ट की सूची देखें; प्रोजेक्ट, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) और समय सीमा से फ़िल्टर करें; कर्सर से पेज बदलें।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| project_id | string | नहीं |

| status | "scheduled" \| "publishing" \| "published" \| "failed" \| "expired" \| "needs_reschedule" \| "cancelled" \| "deleted" | नहीं |

| scheduled_from | string | नहीं |

| scheduled_to | string | नहीं |

| limit | integer | नहीं |

| cursor | object | नहीं |

## sosoapi_post_image_url

पूरी इमेज URL पोस्ट एक बार सबमिट करें, खाली media के साथ। डिस्कनेक्ट होने के बाद भी बैकएंड इसे तैयार करके प्रकाशित करता है। 35 सेकंड के भीतर उपलब्ध होने पर अंतिम प्रकाशन परिणाम, अन्यथा स्थायी post ID लौटाता है; नई key से कभी दोबारा सबमिट न करें। operate और publish के अधिकार आवश्यक हैं। स्थानीय समय/DST फ़ील्ड साथ दिए जाते हैं। import_id केवल पुराने क्लाइंट में प्रक्रिया फिर शुरू करने के लिए है।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:publish + agent:operate। रूट की न्यूनतम भूमिकाएँ: editor, viewer।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: अंतिम प्रकाशन परिणाम पढ़ें; स्वीकृत निर्धारण अभी लंबित है। स्वीकृत इम्पोर्ट लंबित है; उसी इम्पोर्ट को ready या failed तक ट्रैक करें। सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| source_url | string | हाँ |

| post | object | हाँ |

| import_id | string | नहीं |

## sosoapi_publish_scheduled_post_now

निर्धारित पोस्ट को scheduled_at के बजाय तुरंत प्रकाशित करें। सार्वजनिक है और वापस नहीं किया जा सकता; expected_version चाहिए। कतार में होना प्रकाशित होना नहीं है: परिणाम पढ़ें।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:publish। रूट की न्यूनतम भूमिका: editor।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: अंतिम प्रकाशन परिणाम पढ़ें; स्वीकृत निर्धारण अभी लंबित है।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| id | string | हाँ |

| expected_version | integer | हाँ |

## sosoapi_query_assets

asset_type, source या tag से Workspace के एसेट खोजें; एक पेज (limit अधिकतम 100, साथ में offset) और कुल संख्या लौटाता है। workspace_id स्पष्ट रूप से दें।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: true। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: false।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | नहीं |

| asset_type | "text" \| "image" \| "video" \| "audio" \| array ("text" \| "image" \| "video" \| "audio") | नहीं |

| source | string | नहीं |

| tag | string | नहीं |

| limit | integer | नहीं |

| offset | integer | नहीं |

| include_version | boolean | नहीं |

## sosoapi_request_provider_insights

वैकल्पिक तारीख सीमा (अधिकतम 366 दिन) में किसी खाते या एक पोस्ट के इनसाइट प्रोवाइडर से माँगें। request_id और कैश होने पर परिणाम लौटाता है; अन्यथा sosoapi_get_provider_insight_status को पोल करें।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: viewer।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: false। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: प्लेटफ़ॉर्म का परिणाम या उसकी अनुपलब्धता का कारण पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| social_account_id | string | हाँ |

| resource_kind | "account" \| "post" | हाँ |

| provider_resource_id | string | नहीं |

| start_date | string | नहीं |

| end_date | string | नहीं |

| include_audience | boolean | नहीं |

| refresh | boolean | नहीं |

## sosoapi_retry_scheduled_post

विफल निर्धारित पोस्ट का फिर प्रयास करें, चाहें तो नए scheduled_at पर। expected_version आवश्यक है।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:publish। रूट की न्यूनतम भूमिका: editor।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: अंतिम प्रकाशन परिणाम पढ़ें; स्वीकृत निर्धारण अभी लंबित है।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| id | string | हाँ |

| expected_version | integer | हाँ |

| scheduled_at | string | नहीं |

## sosoapi_update_scheduled_post

अभी डिस्पैच न हुई निर्धारित पोस्ट संपादित करें (caption, hashtags, media, link, time)। सबसे हाल में पढ़ा गया expected_version चाहिए; पुराना संस्करण अस्वीकार होता है।

- ट्रांसपोर्ट: stdio, http।

- आवश्यक अधिकार: agent:publish। रूट की न्यूनतम भूमिका: editor।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: अंतिम प्रकाशन परिणाम पढ़ें; स्वीकृत निर्धारण अभी लंबित है।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| id | string | हाँ |

| expected_version | integer | हाँ |

| patch | object | हाँ |

| provider_payload | object \| object \| object \| object \| object | नहीं |

## sosoapi_upload_asset

लोकल इमेज या वीडियो फ़ाइल Workspace एसेट लाइब्रेरी में अपलोड करें और एसेट के रूप में पंजीकृत करें। केवल वर्किंग डायरेक्टरी, टेम्प फ़ोल्डर, Pictures/Movies/Videos या SOSOAPI_UPLOAD_ROOTS से अधिकतम 500 MiB की वास्तविक PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG फ़ाइलें स्वीकार होती हैं; डॉट से शुरू होने वाली फ़ाइलें और फ़ोल्डर अस्वीकार होते हैं। Scheduled Post मीडिया के लिए asset id और URL लौटाता है।

- ट्रांसपोर्ट: stdio।

- आवश्यक अधिकार: agent:operate। रूट की न्यूनतम भूमिका: editor।

- केवल पढ़ने का संकेत: false। इडेम्पोटेंट संकेत: true। बाहरी दुनिया का संकेत: true।

- परिणाम कैसे जाँचें: सिंक्रोनस रिस्पॉन्स पढ़ें।

शीर्ष-स्तरीय इनपुट; नेस्टेड नियम और शर्तों के लिए JSON देखें

| इनपुट | प्रकार | अनिवार्य |

| --- | --- | --- |

| workspace_id | string | हाँ |

| file_path | string | हाँ |

| idempotency_key | string | हाँ |

| content_type | string | नहीं |

| title | string | नहीं |

| description | string | नहीं |

| tags | array (string) | नहीं |

| metadata | object | नहीं |