MCP टूल
शोध हस्तांतरण का उत्पत्ति विवरण पढ़ें
sosoapi_research_briefs_handoff_getmutation_id से ड्राफ़्ट हस्तांतरण रसीद पढ़ें; उत्पत्ति विवरण प्रकाशन अधिकार या प्रकाशन परिणाम नहीं है। agent:research आवश्यक है।
Markdown में पढ़ेंप्रोफ़ाइल और ट्रांसपोर्ट
प्रोफ़ाइल: full · ट्रांसपोर्ट: stdio, http
क्लाइंट में दिखने वाले टूल के लिए core या full चुनें; इससे अनुमतियाँ नहीं बदलतीं। लोकल फ़ाइल अपलोड के लिए stdio चाहिए और HTTP पर उपलब्ध नहीं। खोज में आउटपुट स्कीमा के लिए SOSOAPI_OUTPUT_SCHEMAS=1 सेट करें। इस सेटिंग के साथ या बिना टूल संरचित परिणाम लौटाते हैं।
अनुमतियाँ और अन्य प्रभाव
एनोटेशन क्लाइंट को टूल का वर्णन करने में मदद करते हैं। हर कॉल फिर भी यूज़र का प्रमाणीकरण, भूमिका, संसाधन एक्सेस और क्षमता अधिकार जाँचती है।
{
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}- /research-api/briefs/handoff/get: agent:research · वर्तमान अनुमति वाला सटीक समीक्षित आउटपुट/उत्पत्ति विवरण; स्रोत बदलने पर यह पुराना या अनुपलब्ध हो सकता है
इनपुट फ़ील्ड
Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।
| फ़ील्ड / शाखा | प्रकार / अनिवार्य | शर्तें |
|---|---|---|
$ | objectपैरेंट में अनिवार्य |
|
workspace_id | stringपैरेंट में अनिवार्य |
|
mutation_id | stringपैरेंट में अनिवार्य |
|
संपूर्ण JSON Schema
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"mutation_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"workspace_id",
"mutation_id"
],
"additionalProperties": false
}संरचित आउटपुट
यह स्कीमा सफल टूल परिणाम के structuredContent का वर्णन करता है। MCP रिस्पॉन्स में content भी होता है और कॉल विफल होने पर isError सेट हो सकता है। प्रकाशन के लिए स्वीकृत अनुरोध या टेक्स्ट रिस्पॉन्स को पुष्टि मानने के बजाय पोस्ट का अंतिम परिणाम पढ़ें। लिंक किया गया API ऑपरेशन अनुमतियाँ और पुनः प्रयास के नियम समझाता है।
Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।
| फ़ील्ड / शाखा | प्रकार / अनिवार्य | शर्तें |
|---|---|---|
$ | objectपैरेंट में अनिवार्य |
|
handoff | objectपैरेंट में अनिवार्य |
|
handoff.id | stringपैरेंट में अनिवार्य |
|
handoff.workspace_id | stringपैरेंट में अनिवार्य |
|
handoff.mutation_id | stringपैरेंट में अनिवार्य |
|
handoff.brief_id | stringपैरेंट में अनिवार्य |
|
handoff.brief_revision | integerपैरेंट में अनिवार्य |
|
handoff.variant | objectपैरेंट में अनिवार्य |
|
handoff.variant.id | stringपैरेंट में अनिवार्य |
|
handoff.variant.revision | integerपैरेंट में अनिवार्य |
|
handoff.variant.locale | stringपैरेंट में अनिवार्य |
|
handoff.draft_id | string | nullपैरेंट में अनिवार्य | — |
handoff.draft_idanyOf 1 | stringपैरेंट में अनिवार्य |
|
handoff.draft_idanyOf 2 | nullपैरेंट में अनिवार्य | — |
handoff.draft_revision | integerपैरेंट में अनिवार्य |
|
handoff.created_at | stringपैरेंट में अनिवार्य |
|
handoff.evidence | arrayपैरेंट में अनिवार्य |
|
handoff.evidence[] | objectवैकल्पिक / आइटम |
|
handoff.evidence[].evidence_id | stringपैरेंट में अनिवार्य |
|
handoff.evidence[].revision | integerपैरेंट में अनिवार्य |
|
handoff.locked_finding_ids | arrayपैरेंट में अनिवार्य |
|
handoff.locked_finding_ids[] | stringवैकल्पिक / आइटम |
|
handoff.availability | stringपैरेंट में अनिवार्य |
|
handoff.reasons | arrayपैरेंट में अनिवार्य |
|
handoff.reasons[] | stringवैकल्पिक / आइटम |
|
handoff.method | stringपैरेंट में अनिवार्य |
|
draft | object | nullपैरेंट में अनिवार्य | — |
draftanyOf 1 | objectपैरेंट में अनिवार्य |
|
draft.idanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.workspace_idanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.revisionanyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.stateanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.contentanyOf 1 | objectपैरेंट में अनिवार्य |
|
draft.content.schemaVersionanyOf 1 | numberपैरेंट में अनिवार्य |
|
draft.content.accountIdsanyOf 1 | arrayपैरेंट में अनिवार्य |
|
draft.content.accountIds[]anyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.captionanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.hashtagsanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.assetIdsanyOf 1 | arrayपैरेंट में अनिवार्य |
|
draft.content.assetIds[]anyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsTextOnlyanyOf 1 | booleanपैरेंट में अनिवार्य |
|
draft.content.threadsOptionsanyOf 1 | objectवैकल्पिक / आइटम |
|
draft.content.threadsOptions.post_typeanyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.reply_to_idanyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.quote_post_idanyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.repost_target_idanyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.reply_controlanyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.enable_reply_approvalsanyOf 1 | booleanवैकल्पिक / आइटम | — |
draft.content.threadsOptions.link_attachmentanyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.poll_attachmentanyOf 1 | objectवैकल्पिक / आइटम |
|
draft.content.threadsOptions.poll_attachment.option_aanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.poll_attachment.option_banyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.poll_attachment.option_canyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.poll_attachment.option_danyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.gif_attachmentanyOf 1 | objectवैकल्पिक / आइटम |
|
draft.content.threadsOptions.gif_attachment.gif_idanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.gif_attachment.provideranyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.text_attachmentanyOf 1 | objectवैकल्पिक / आइटम |
|
draft.content.threadsOptions.text_attachment.plaintextanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.text_attachment.link_attachment_urlanyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.text_attachment.text_with_styling_infoanyOf 1 | arrayवैकल्पिक / आइटम |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[]anyOf 1 | objectवैकल्पिक / आइटम |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].offsetanyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].lengthanyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].styling_infoanyOf 1 | arrayपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].styling_info[]anyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.topic_taganyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.text_entitiesanyOf 1 | arrayवैकल्पिक / आइटम |
|
draft.content.threadsOptions.text_entities[]anyOf 1 | objectवैकल्पिक / आइटम |
|
draft.content.threadsOptions.text_entities[].entity_typeanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.text_entities[].offsetanyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.text_entities[].lengthanyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.is_spoiler_mediaanyOf 1 | booleanवैकल्पिक / आइटम | — |
draft.content.threadsOptions.is_ghost_postanyOf 1 | booleanवैकल्पिक / आइटम | — |
draft.content.threadsOptions.location_idanyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.allowlisted_country_codesanyOf 1 | arrayवैकल्पिक / आइटम |
|
draft.content.threadsOptions.allowlisted_country_codes[]anyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.crossreshare_to_iganyOf 1 | booleanवैकल्पिक / आइटम | — |
draft.content.threadsOptions.crossreshare_to_ig_dark_modeanyOf 1 | booleanवैकल्पिक / आइटम | — |
draft.content.threadsOptions.auto_publish_textanyOf 1 | booleanवैकल्पिक / आइटम | — |
draft.content.threadsOptions.media_optionsanyOf 1 | arrayवैकल्पिक / आइटम |
|
draft.content.threadsOptions.media_options[]anyOf 1 | objectवैकल्पिक / आइटम |
|
draft.content.threadsOptions.media_options[].asset_idanyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.content.threadsOptions.media_options[].alt_textanyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.threadsOptions.media_options[].is_spoiler_mediaanyOf 1 | booleanवैकल्पिक / आइटम | — |
draft.content.instagramModeanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.youtubeTitleanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.youtubePrivacyanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.youtubeSyntheticanyOf 1 | booleanपैरेंट में अनिवार्य |
|
draft.content.youtubeCategoryIdanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.youtubeShortanyOf 1 | booleanपैरेंट में अनिवार्य |
|
draft.content.linkUrlanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.scheduledAtanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.displayTimezoneanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.content.publishNowanyOf 1 | booleanपैरेंट में अनिवार्य |
|
draft.content.destinationOverridesanyOf 1 | objectपैरेंट में अनिवार्य |
|
draft.content.destinationOverrides.*anyOf 1 | objectवैकल्पिक / आइटम |
|
draft.content.destinationOverrides.*.captionanyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.destinationOverrides.*.scheduledAtanyOf 1 | stringवैकल्पिक / आइटम |
|
draft.content.expiresAtanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.created_byanyOf 1 | string | nullपैरेंट में अनिवार्य | — |
draft.created_byanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.created_byanyOf 1 / anyOf 2 | nullपैरेंट में अनिवार्य | — |
draft.updated_byanyOf 1 | string | nullपैरेंट में अनिवार्य | — |
draft.updated_byanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.updated_byanyOf 1 / anyOf 2 | nullपैरेंट में अनिवार्य | — |
draft.created_atanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.updated_atanyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.submissionanyOf 1 | object | nullपैरेंट में अनिवार्य | — |
draft.submissionanyOf 1 / anyOf 1 | objectपैरेंट में अनिवार्य |
|
draft.submission.idanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.submission.expected_revisionanyOf 1 / anyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.submission.started_atanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.submission.receiptanyOf 1 / anyOf 1 | object | nullपैरेंट में अनिवार्य | — |
draft.submission.receiptanyOf 1 / anyOf 1 / anyOf 1 | objectपैरेंट में अनिवार्य |
|
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 | string | nullपैरेंट में अनिवार्य | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullपैरेंट में अनिवार्य | — |
draft.submission.receipt.successesanyOf 1 / anyOf 1 / anyOf 1 | arrayपैरेंट में अनिवार्य |
|
draft.submission.receipt.successes[]anyOf 1 / anyOf 1 / anyOf 1 | objectवैकल्पिक / आइटम |
|
draft.submission.receipt.successes[].social_account_idanyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.submission.receipt.successes[].post_idanyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.submission.receipt.failuresanyOf 1 / anyOf 1 / anyOf 1 | arrayपैरेंट में अनिवार्य |
|
draft.submission.receipt.failures[]anyOf 1 / anyOf 1 / anyOf 1 | objectवैकल्पिक / आइटम |
|
draft.submission.receipt.failures[].social_account_idanyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.submission.receipt.failures[].codeanyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.submission.receipt.failures[].messageanyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.submission.receiptanyOf 1 / anyOf 1 / anyOf 2 | nullपैरेंट में अनिवार्य | — |
draft.submissionanyOf 1 / anyOf 2 | nullपैरेंट में अनिवार्य | — |
draft.brand_contextanyOf 1 | object | nullवैकल्पिक / आइटम | — |
draft.brand_contextanyOf 1 / anyOf 1 | objectवैकल्पिक / आइटम |
|
draft.brand_context.workspace_idanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.selectionanyOf 1 / anyOf 1 | objectपैरेंट में अनिवार्य |
|
draft.brand_context.selection.profile_idanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.selection.version_idanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.selection.revisionanyOf 1 / anyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.brand_context.selection.content_digestanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.selection.context_digestanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.availabilityanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.profile_stateanyOf 1 / anyOf 1 | string | nullपैरेंट में अनिवार्य | — |
draft.brand_context.profile_stateanyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.profile_stateanyOf 1 / anyOf 1 / anyOf 2 | nullपैरेंट में अनिवार्य | — |
draft.brand_context.contentanyOf 1 / anyOf 1 | object | nullपैरेंट में अनिवार्य | — |
draft.brand_context.contentanyOf 1 / anyOf 1 / anyOf 1 | objectपैरेंट में अनिवार्य |
|
draft.brand_context.content.nameanyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.content.audienceanyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.content.voiceanyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 | string | nullपैरेंट में अनिवार्य | — |
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullपैरेंट में अनिवार्य | — |
draft.brand_context.content.preferred_termsanyOf 1 / anyOf 1 / anyOf 1 | arrayपैरेंट में अनिवार्य |
|
draft.brand_context.content.preferred_terms[]anyOf 1 / anyOf 1 / anyOf 1 | stringवैकल्पिक / आइटम |
|
draft.brand_context.content.prohibited_termsanyOf 1 / anyOf 1 / anyOf 1 | arrayपैरेंट में अनिवार्य |
|
draft.brand_context.content.prohibited_terms[]anyOf 1 / anyOf 1 / anyOf 1 | stringवैकल्पिक / आइटम |
|
draft.brand_context.content.locked_factsanyOf 1 / anyOf 1 / anyOf 1 | arrayपैरेंट में अनिवार्य |
|
draft.brand_context.content.locked_facts[]anyOf 1 / anyOf 1 / anyOf 1 | stringवैकल्पिक / आइटम |
|
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 | string | nullपैरेंट में अनिवार्य | — |
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullपैरेंट में अनिवार्य | — |
draft.brand_context.contentanyOf 1 / anyOf 1 / anyOf 2 | nullपैरेंट में अनिवार्य | — |
draft.brand_context.sourcesanyOf 1 / anyOf 1 | objectपैरेंट में अनिवार्य |
|
draft.brand_context.sources.websiteanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.sources.logoanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_context.sources.own_postsanyOf 1 / anyOf 1 | objectपैरेंट में अनिवार्य |
|
draft.brand_context.sources.own_posts.selectedanyOf 1 / anyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.brand_context.sources.own_posts.availableanyOf 1 / anyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.brand_context.sources.own_posts.unavailableanyOf 1 / anyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.brand_context.sources.own_posts.erasedanyOf 1 / anyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.brand_contextanyOf 1 / anyOf 2 | nullवैकल्पिक / आइटम | — |
draft.brand_reviewanyOf 1 | object | nullवैकल्पिक / आइटम | — |
draft.brand_reviewanyOf 1 / anyOf 1 | objectवैकल्पिक / आइटम |
|
draft.brand_review.rule_versionanyOf 1 / anyOf 1 | numberपैरेंट में अनिवार्य |
|
draft.brand_review.context_digestanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_review.content_digestanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_review.statusanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_review.issuesanyOf 1 / anyOf 1 | arrayपैरेंट में अनिवार्य |
|
draft.brand_review.issues[]anyOf 1 / anyOf 1 | objectवैकल्पिक / आइटम |
|
draft.brand_review.issues[].codeanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_review.issues[].targetanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 | integer | nullपैरेंट में अनिवार्य | — |
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 / anyOf 1 | integerपैरेंट में अनिवार्य |
|
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 / anyOf 2 | nullपैरेंट में अनिवार्य | — |
draft.brand_review.issues[].messageanyOf 1 / anyOf 1 | stringपैरेंट में अनिवार्य |
|
draft.brand_reviewanyOf 1 / anyOf 2 | nullवैकल्पिक / आइटम | — |
draftanyOf 2 | nullपैरेंट में अनिवार्य | — |
संपूर्ण JSON Schema
{
"type": "object",
"properties": {
"handoff": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"mutation_id": {
"type": "string",
"format": "uuid"
},
"brief_id": {
"type": "string",
"format": "uuid"
},
"brief_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"variant": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"locale": {
"type": "string",
"enum": [
"en",
"zh-HK"
]
}
},
"required": [
"id",
"revision",
"locale"
],
"additionalProperties": false
},
"draft_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"draft_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"created_at": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
"evidence": {
"maxItems": 500,
"type": "array",
"items": {
"type": "object",
"properties": {
"evidence_id": {
"type": "string",
"format": "uuid"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"evidence_id",
"revision"
],
"additionalProperties": false
}
},
"locked_finding_ids": {
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
},
"availability": {
"type": "string",
"enum": [
"available",
"stale",
"unavailable"
]
},
"reasons": {
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"source_unavailable",
"source_changed",
"brief_changed",
"variant_changed",
"draft_changed",
"draft_unavailable",
"not_reviewed"
]
}
},
"method": {
"type": "string",
"const": "reviewed_manual_handoff/v1"
}
},
"required": [
"id",
"workspace_id",
"mutation_id",
"brief_id",
"brief_revision",
"variant",
"draft_id",
"draft_revision",
"created_at",
"evidence",
"locked_finding_ids",
"availability",
"reasons",
"method"
],
"additionalProperties": false
},
"draft": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"state": {
"type": "string",
"enum": [
"draft",
"submitting",
"submitted"
]
},
"content": {
"type": "object",
"properties": {
"schemaVersion": {
"default": 1,
"type": "number",
"const": 1
},
"accountIds": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
},
"caption": {
"default": "",
"type": "string",
"maxLength": 5000
},
"hashtags": {
"default": "",
"type": "string",
"maxLength": 5000
},
"assetIds": {
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"maxLength": 16,
"pattern": "^[1-9][0-9]*$"
}
},
"threadsTextOnly": {
"default": false,
"type": "boolean"
},
"threadsOptions": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"TEXT",
"IMAGE",
"VIDEO",
"CAROUSEL",
"REPOST"
]
},
"reply_to_id": {
"type": "string",
"maxLength": 128
},
"quote_post_id": {
"type": "string",
"maxLength": 128
},
"repost_target_id": {
"type": "string",
"maxLength": 128
},
"reply_control": {
"type": "string",
"enum": [
"everyone",
"accounts_you_follow",
"mentioned_only",
"parent_post_author_only",
"followers_only"
]
},
"enable_reply_approvals": {
"type": "boolean"
},
"link_attachment": {
"type": "string",
"maxLength": 2048
},
"poll_attachment": {
"type": "object",
"properties": {
"option_a": {
"type": "string",
"maxLength": 25
},
"option_b": {
"type": "string",
"maxLength": 25
},
"option_c": {
"type": "string",
"maxLength": 25
},
"option_d": {
"type": "string",
"maxLength": 25
}
},
"required": [
"option_a",
"option_b"
],
"additionalProperties": false
},
"gif_attachment": {
"type": "object",
"properties": {
"gif_id": {
"type": "string",
"maxLength": 128
},
"provider": {
"type": "string",
"const": "GIPHY"
}
},
"required": [
"gif_id",
"provider"
],
"additionalProperties": false
},
"text_attachment": {
"type": "object",
"properties": {
"plaintext": {
"type": "string",
"maxLength": 10000
},
"link_attachment_url": {
"type": "string",
"maxLength": 2048
},
"text_with_styling_info": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"length": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"styling_info": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"bold",
"italic",
"highlight",
"underline",
"strikethrough"
]
}
}
},
"required": [
"offset",
"length",
"styling_info"
],
"additionalProperties": false
}
}
},
"required": [
"plaintext"
],
"additionalProperties": false
},
"topic_tag": {
"type": "string",
"maxLength": 50
},
"text_entities": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_type": {
"type": "string",
"enum": [
"SPOILER",
"spoiler"
]
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"length": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"entity_type",
"offset",
"length"
],
"additionalProperties": false
}
},
"is_spoiler_media": {
"type": "boolean"
},
"is_ghost_post": {
"type": "boolean"
},
"location_id": {
"type": "string",
"maxLength": 128
},
"allowlisted_country_codes": {
"minItems": 1,
"maxItems": 249,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"crossreshare_to_ig": {
"type": "boolean"
},
"crossreshare_to_ig_dark_mode": {
"type": "boolean"
},
"auto_publish_text": {
"type": "boolean"
},
"media_options": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"alt_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"is_spoiler_media": {
"type": "boolean"
}
},
"required": [
"asset_id"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"instagramMode": {
"default": "REELS",
"type": "string",
"enum": [
"IMAGE",
"REELS",
"CAROUSEL",
"STORY_IMAGE",
"STORY_VIDEO"
]
},
"youtubeTitle": {
"default": "",
"type": "string",
"maxLength": 100
},
"youtubePrivacy": {
"default": "private",
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"youtubeSynthetic": {
"default": false,
"type": "boolean"
},
"youtubeCategoryId": {
"default": "",
"type": "string",
"maxLength": 32
},
"youtubeShort": {
"default": false,
"type": "boolean"
},
"linkUrl": {
"default": "",
"type": "string",
"maxLength": 2048
},
"scheduledAt": {
"default": "",
"type": "string",
"maxLength": 64
},
"displayTimezone": {
"default": "UTC",
"type": "string",
"minLength": 1,
"maxLength": 128
},
"publishNow": {
"default": false,
"type": "boolean"
},
"destinationOverrides": {
"default": {},
"type": "object",
"propertyNames": {
"type": "string",
"format": "uuid"
},
"additionalProperties": {
"type": "object",
"properties": {
"caption": {
"type": "string",
"maxLength": 5000
},
"scheduledAt": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
}
},
"expiresAt": {
"default": "",
"type": "string",
"maxLength": 64
}
},
"required": [
"schemaVersion",
"accountIds",
"caption",
"hashtags",
"assetIds",
"threadsTextOnly",
"instagramMode",
"youtubeTitle",
"youtubePrivacy",
"youtubeSynthetic",
"youtubeCategoryId",
"youtubeShort",
"linkUrl",
"scheduledAt",
"displayTimezone",
"publishNow",
"destinationOverrides",
"expiresAt"
],
"additionalProperties": false
},
"created_by": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"updated_by": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
"updated_at": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
"submission": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"expected_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"started_at": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
"receipt": {
"anyOf": [
{
"type": "object",
"properties": {
"batch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"successes": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"social_account_id": {
"type": "string",
"format": "uuid"
},
"post_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
},
"required": [
"social_account_id",
"post_id"
],
"additionalProperties": false
}
},
"failures": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"social_account_id": {
"type": "string",
"format": "uuid"
},
"code": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"message": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"social_account_id",
"code",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"batch_id",
"successes",
"failures"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"expected_revision",
"started_at",
"receipt"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"brand_context": {
"anyOf": [
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"selection": {
"type": "object",
"properties": {
"profile_id": {
"type": "string",
"format": "uuid"
},
"version_id": {
"type": "string",
"format": "uuid"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"content_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"context_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"profile_id",
"version_id",
"revision",
"content_digest",
"context_digest"
],
"additionalProperties": false
},
"availability": {
"type": "string",
"enum": [
"available",
"missing"
]
},
"profile_state": {
"anyOf": [
{
"type": "string",
"enum": [
"active",
"archived"
]
},
{
"type": "null"
}
]
},
"content": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"audience": {
"type": "string",
"maxLength": 2000
},
"voice": {
"type": "string",
"maxLength": 2000
},
"language": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"preferred_terms": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"prohibited_terms": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"locked_facts": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"call_to_action": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"audience",
"voice",
"language",
"preferred_terms",
"prohibited_terms",
"locked_facts",
"call_to_action"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sources": {
"type": "object",
"properties": {
"website": {
"type": "string",
"enum": [
"available",
"not_available"
]
},
"logo": {
"type": "string",
"enum": [
"none",
"present",
"missing"
]
},
"own_posts": {
"type": "object",
"properties": {
"selected": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"available": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"unavailable": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"erased": {
"type": "integer",
"minimum": 0,
"maximum": 10
}
},
"required": [
"selected",
"available",
"unavailable",
"erased"
],
"additionalProperties": false
}
},
"required": [
"website",
"logo",
"own_posts"
],
"additionalProperties": false
}
},
"required": [
"workspace_id",
"selection",
"availability",
"profile_state",
"content",
"sources"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"brand_review": {
"anyOf": [
{
"type": "object",
"properties": {
"rule_version": {
"type": "number",
"const": 1
},
"context_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"content_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"status": {
"type": "string",
"enum": [
"clear",
"attention",
"unavailable"
]
},
"issues": {
"maxItems": 5151,
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"enum": [
"prohibited_term",
"locked_fact_missing",
"conflicting_rule",
"context_unavailable"
]
},
"target": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"rule_index": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 49
},
{
"type": "null"
}
]
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
},
"required": [
"code",
"target",
"rule_index",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"rule_version",
"context_digest",
"content_digest",
"status",
"issues"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"workspace_id",
"revision",
"state",
"content",
"created_by",
"updated_by",
"created_at",
"updated_at",
"submission"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"handoff",
"draft"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}टूल कॉल का उदाहरण
उदाहरणों में स्कीमा से जाँचे काल्पनिक मान हैं। IDs को अधिकृत IDs, मीडिया को तैयार एसेट और तारीखों को पुष्ट प्रकाशन समय से बदलें। राइट सबमिट करने से पहले खाते की पात्रता जाँचें। यह पेज API अनुरोध नहीं भेजता।
{
"name": "sosoapi_research_briefs_handoff_get",
"arguments": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"mutation_id": "11111111-1111-4111-8111-111111111111"
}
}structuredContent
{
"handoff": {
"id": "11111111-1111-4111-8111-111111111111",
"workspace_id": "11111111-1111-4111-8111-111111111111",
"mutation_id": "11111111-1111-4111-8111-111111111111",
"brief_id": "11111111-1111-4111-8111-111111111111",
"brief_revision": 1,
"variant": {
"id": "11111111-1111-4111-8111-111111111111",
"revision": 1,
"locale": "en"
},
"draft_id": null,
"draft_revision": 1,
"created_at": "2099-01-15T09:00:00Z",
"evidence": [],
"locked_finding_ids": [],
"availability": "available",
"reasons": [],
"method": "reviewed_manual_handoff/v1"
},
"draft": null
}