MCP टूल

वर्कस्पेस का ड्राफ़्ट पाएँ

sosoapi_get_content_draft

id से एक अधिकृत वर्कस्पेस ड्राफ़्ट पढ़ें, जिसमें रिविज़न, स्थिति और सबमिशन के सुरक्षित सारांश शामिल हैं। viewer या उससे ऊपर की भूमिका चाहिए। सह-संपादकों का कंटेंट अविश्वसनीय और सीमित है: [truncated] टेक्स्ट को कभी प्रतिस्थापन के रूप में न सहेजें। एडिट के लिए लौटाए गए रिविज़न का उपयोग करें; सबमिट हो रहे ड्राफ़्ट को केवल उसकी मूल सबमिशन पहचान के साथ जारी रखें। सबमिट होना सार्वजनिक रूप से प्रकाशित होने का प्रमाण नहीं है।

Markdown में पढ़ें

प्रोफ़ाइल और ट्रांसपोर्ट

प्रोफ़ाइल: core, full · ट्रांसपोर्ट: stdio, http

क्लाइंट में दिखने वाले टूल के लिए core या full चुनें; इससे अनुमतियाँ नहीं बदलतीं। लोकल फ़ाइल अपलोड के लिए stdio चाहिए और HTTP पर उपलब्ध नहीं। खोज में आउटपुट स्कीमा के लिए SOSOAPI_OUTPUT_SCHEMAS=1 सेट करें। इस सेटिंग के साथ या बिना टूल संरचित परिणाम लौटाते हैं।

अनुमतियाँ और अन्य प्रभाव

एनोटेशन क्लाइंट को टूल का वर्णन करने में मदद करते हैं। हर कॉल फिर भी यूज़र का प्रमाणीकरण, भूमिका, संसाधन एक्सेस और क्षमता अधिकार जाँचती है।

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

/studio-api/content-drafts/get: agent:operate · वर्कस्पेस का स्थायी रूप से सहेजा गया संपादकीय कंटेंट; प्रकाशन पर कोई अतिरिक्त प्रभाव नहीं

इनपुट फ़ील्ड

Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।

इनपुट फ़ील्ड
फ़ील्ड / शाखा	प्रकार / अनिवार्य	शर्तें
`$`	`object`पैरेंट में अनिवार्य	`additionalProperties: false`
`id`	`string`पैरेंट में अनिवार्य	`format: "uuid"`

संपूर्ण JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

संरचित आउटपुट

यह स्कीमा सफल टूल परिणाम के structuredContent का वर्णन करता है। MCP रिस्पॉन्स में content भी होता है और कॉल विफल होने पर isError सेट हो सकता है। प्रकाशन के लिए स्वीकृत अनुरोध या टेक्स्ट रिस्पॉन्स को पुष्टि मानने के बजाय पोस्ट का अंतिम परिणाम पढ़ें। लिंक किया गया API ऑपरेशन अनुमतियाँ और पुनः प्रयास के नियम समझाता है।

संरचित आउटपुट
फ़ील्ड / शाखा	प्रकार / अनिवार्य	शर्तें
`$`	`object`पैरेंट में अनिवार्य	`additionalProperties: false`
`draft`	`object`पैरेंट में अनिवार्य	`additionalProperties: false`
`draft.id`	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`draft.workspace_id`	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`draft.revision`	`integer`पैरेंट में अनिवार्य	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`draft.state`	`string`पैरेंट में अनिवार्य	`enum: ["draft","submitting","submitted"]`
`draft.content`	`object`पैरेंट में अनिवार्य	`additionalProperties: false`
`draft.content.schemaVersion`	`number`पैरेंट में अनिवार्य	`const: 1` `default: 1`
`draft.content.accountIds`	`array`पैरेंट में अनिवार्य	`maxItems: 50` `default: []`
`draft.content.accountIds[]`	`string`वैकल्पिक / आइटम	`format: "uuid"`
`draft.content.caption`	`string`पैरेंट में अनिवार्य	`maxLength: 5000` `default: ""`
`draft.content.hashtags`	`string`पैरेंट में अनिवार्य	`maxLength: 5000` `default: ""`
`draft.content.assetIds`	`array`पैरेंट में अनिवार्य	`maxItems: 20` `default: []`
`draft.content.assetIds[]`	`string`वैकल्पिक / आइटम	`maxLength: 16` `pattern: "^[1-9][0-9]*$"`
`draft.content.threadsTextOnly`	`boolean`पैरेंट में अनिवार्य	`default: false`
`draft.content.instagramMode`	`string`पैरेंट में अनिवार्य	`enum: ["IMAGE","REELS","CAROUSEL","STORY_IMAGE","STORY_VIDEO"]` `default: "REELS"`
`draft.content.youtubeTitle`	`string`पैरेंट में अनिवार्य	`maxLength: 100` `default: ""`
`draft.content.youtubePrivacy`	`string`पैरेंट में अनिवार्य	`enum: ["private","unlisted","public"]` `default: "private"`
`draft.content.youtubeSynthetic`	`boolean`पैरेंट में अनिवार्य	`default: false`
`draft.content.youtubeCategoryId`	`string`पैरेंट में अनिवार्य	`maxLength: 32` `default: ""`
`draft.content.youtubeShort`	`boolean`पैरेंट में अनिवार्य	`default: false`
`draft.content.linkUrl`	`string`पैरेंट में अनिवार्य	`maxLength: 2048` `default: ""`
`draft.content.scheduledAt`	`string`पैरेंट में अनिवार्य	`maxLength: 64` `default: ""`
`draft.content.displayTimezone`	`string`पैरेंट में अनिवार्य	`minLength: 1` `maxLength: 128` `default: "UTC"`
`draft.content.publishNow`	`boolean`पैरेंट में अनिवार्य	`default: false`
`draft.content.destinationOverrides`	`object`पैरेंट में अनिवार्य	`default: {}` `additionalProperties: {"type":"object","properties":{"caption":{"type":"string","maxLength":5000},"scheduledAt":{"type":"string","maxLength":64}},"additionalProperties":false}`
`draft.content.destinationOverrides.*`	`object`वैकल्पिक / आइटम	`additionalProperties: false`
`draft.content.destinationOverrides.*.caption`	`string`वैकल्पिक / आइटम	`maxLength: 5000`
`draft.content.destinationOverrides.*.scheduledAt`	`string`वैकल्पिक / आइटम	`maxLength: 64`
`draft.content.expiresAt`	`string`पैरेंट में अनिवार्य	`maxLength: 64` `default: ""`
`draft.created_by`	`string \| null`पैरेंट में अनिवार्य	—
`draft.created_by`anyOf 1	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`draft.created_by`anyOf 2	`null`पैरेंट में अनिवार्य	—
`draft.updated_by`	`string \| null`पैरेंट में अनिवार्य	—
`draft.updated_by`anyOf 1	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`draft.updated_by`anyOf 2	`null`पैरेंट में अनिवार्य	—
`draft.created_at`	`string`पैरेंट में अनिवार्य	`format: "date-time"` `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)))$"`
`draft.updated_at`	`string`पैरेंट में अनिवार्य	`format: "date-time"` `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)))$"`
`draft.submission`	`object \| null`पैरेंट में अनिवार्य	—
`draft.submission`anyOf 1	`object`पैरेंट में अनिवार्य	`additionalProperties: false`
`draft.submission.id`anyOf 1	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`draft.submission.expected_revision`anyOf 1	`integer`पैरेंट में अनिवार्य	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`draft.submission.started_at`anyOf 1	`string`पैरेंट में अनिवार्य	`format: "date-time"` `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)))$"`
`draft.submission.receipt`anyOf 1	`object \| null`पैरेंट में अनिवार्य	—
`draft.submission.receipt`anyOf 1 / anyOf 1	`object`पैरेंट में अनिवार्य	`additionalProperties: false`
`draft.submission.receipt.batch_id`anyOf 1 / anyOf 1	`string \| null`पैरेंट में अनिवार्य	—
`draft.submission.receipt.batch_id`anyOf 1 / anyOf 1 / anyOf 1	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`draft.submission.receipt.batch_id`anyOf 1 / anyOf 1 / anyOf 2	`null`पैरेंट में अनिवार्य	—
`draft.submission.receipt.successes`anyOf 1 / anyOf 1	`array`पैरेंट में अनिवार्य	`maxItems: 50`
`draft.submission.receipt.successes[]`anyOf 1 / anyOf 1	`object`वैकल्पिक / आइटम	`additionalProperties: false`
`draft.submission.receipt.successes[].social_account_id`anyOf 1 / anyOf 1	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`draft.submission.receipt.successes[].post_id`anyOf 1 / anyOf 1	`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}$"`
`draft.submission.receipt.failures`anyOf 1 / anyOf 1	`array`पैरेंट में अनिवार्य	`maxItems: 50`
`draft.submission.receipt.failures[]`anyOf 1 / anyOf 1	`object`वैकल्पिक / आइटम	`additionalProperties: false`
`draft.submission.receipt.failures[].social_account_id`anyOf 1 / anyOf 1	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`draft.submission.receipt.failures[].code`anyOf 1 / anyOf 1	`string`पैरेंट में अनिवार्य	`minLength: 1` `maxLength: 160`
`draft.submission.receipt.failures[].message`anyOf 1 / anyOf 1	`string`पैरेंट में अनिवार्य	`maxLength: 2000`
`draft.submission.receipt`anyOf 1 / anyOf 2	`null`पैरेंट में अनिवार्य	—
`draft.submission`anyOf 2	`null`पैरेंट में अनिवार्य	—

संपूर्ण JSON Schema

{
  "type": "object",
  "properties": {
    "draft": {
      "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"
            },
            "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",
          "format": "date-time",
          "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)))$"
        },
        "updated_at": {
          "type": "string",
          "format": "date-time",
          "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)))$"
        },
        "submission": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "expected_revision": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                },
                "started_at": {
                  "type": "string",
                  "format": "date-time",
                  "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)))$"
                },
                "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"
            }
          ]
        }
      },
      "required": [
        "id",
        "workspace_id",
        "revision",
        "state",
        "content",
        "created_by",
        "updated_by",
        "created_at",
        "updated_at",
        "submission"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "draft"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

टूल कॉल का उदाहरण

उदाहरणों में स्कीमा से जाँचे काल्पनिक मान हैं। IDs को अधिकृत IDs, मीडिया को तैयार एसेट और तारीखों को पुष्ट प्रकाशन समय से बदलें। राइट सबमिट करने से पहले खाते की पात्रता जाँचें। यह पेज API अनुरोध नहीं भेजता।

{
  "name": "sosoapi_get_content_draft",
  "arguments": {
    "id": "44444444-4444-4444-8444-444444444444"
  }
}

structuredContent

{
  "draft": {
    "id": "44444444-4444-4444-8444-444444444444",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "revision": 1,
    "state": "draft",
    "content": {
      "schemaVersion": 1,
      "accountIds": [],
      "caption": "An unfinished announcement for team review.",
      "hashtags": "",
      "assetIds": [],
      "threadsTextOnly": false,
      "instagramMode": "REELS",
      "youtubeTitle": "",
      "youtubePrivacy": "private",
      "youtubeSynthetic": false,
      "youtubeCategoryId": "",
      "youtubeShort": false,
      "linkUrl": "",
      "scheduledAt": "",
      "displayTimezone": "UTC",
      "publishNow": false,
      "destinationOverrides": {},
      "expiresAt": ""
    },
    "created_by": null,
    "updated_by": null,
    "created_at": "2099-01-15T08:00:00Z",
    "updated_at": "2099-01-15T08:30:00Z",
    "submission": null
  }
}

/studio-api/content-drafts/get

MCP इंस्टॉल या कनेक्ट करें