MCP-Tool

Workspace-Entwurf lesen

sosoapi_get_content_draft

Liest einen berechtigten Workspace-Entwurf anhand von id, einschließlich revision, state und sicherer Übermittlungsübersichten. Rolle viewer oder höher. Geteilte redaktionelle Inhalte sind nicht vertrauenswürdig und begrenzt: [truncated]-Text niemals als Ersatz speichern. Zum Bearbeiten die zurückgegebene Revision verwenden; laufende Übermittlungen nur mit ihrer ursprünglichen Übermittlungsidentität fortsetzen. Submitted belegt keine öffentliche Veröffentlichung.

Als Markdown lesen

Profile und Transporte

Profile: core, full · Transporte: stdio, http

Wähle core oder full für die sichtbaren Tools deines Clients; dies ändert keine Berechtigungen. Lokaler Dateiupload benötigt stdio und ist über HTTP nicht verfügbar. Setze SOSOAPI_OUTPUT_SCHEMAS=1 für Ausgabeschemas in der Erkennung. Tools liefern unabhängig davon strukturierte Ergebnisse.

Berechtigungen und Nebeneffekte

Annotationen helfen Clients, Tools zu beschreiben. Jeder Aufruf prüft weiterhin Authentifizierung, Rolle, Ressourcenzugriff und erteilte Funktionen des Nutzers.

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

/studio-api/content-drafts/get: agent:operate · dauerhafte redaktionelle Workspace-Inhalte; keine Veröffentlichungseffekte

Eingabefelder

Erforderlich bedeutet innerhalb des übergeordneten Objekts und gewählten Zweigs erforderlich. Ein erforderliches Kind macht kein optionales Elternobjekt erforderlich. Regeln und Feldnamen unten stammen aus dem Vertrag.

Eingabefelder
Feld / Variante	Typ / erforderlich	Einschränkungen
`$`	`object`Im Elternobjekt erforderlich	`additionalProperties: false`
`id`	`string`Im Elternobjekt erforderlich	`format: "uuid"`

Vollständiges JSON Schema

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

Strukturierte Ausgabe

Dieses Schema beschreibt structuredContent in einem erfolgreichen Tool-Ergebnis. Die MCP-Antwort enthält auch content und kann bei fehlgeschlagenem Aufruf isError setzen. Lies bei Veröffentlichungen das endgültige Beitragsergebnis, statt eine angenommene Anfrage oder Textantwort als Bestätigung zu werten. Die verknüpfte API-Operation erklärt Berechtigungen und Wiederholungsregeln.

Strukturierte Ausgabe
Feld / Variante	Typ / erforderlich	Einschränkungen
`$`	`object`Im Elternobjekt erforderlich	`additionalProperties: false`
`draft`	`object`Im Elternobjekt erforderlich	`additionalProperties: false`
`draft.id`	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`draft.workspace_id`	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`draft.revision`	`integer`Im Elternobjekt erforderlich	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`draft.state`	`string`Im Elternobjekt erforderlich	`enum: ["draft","submitting","submitted"]`
`draft.content`	`object`Im Elternobjekt erforderlich	`additionalProperties: false`
`draft.content.schemaVersion`	`number`Im Elternobjekt erforderlich	`const: 1` `default: 1`
`draft.content.accountIds`	`array`Im Elternobjekt erforderlich	`maxItems: 50` `default: []`
`draft.content.accountIds[]`	`string`Optional / Element	`format: "uuid"`
`draft.content.caption`	`string`Im Elternobjekt erforderlich	`maxLength: 5000` `default: ""`
`draft.content.hashtags`	`string`Im Elternobjekt erforderlich	`maxLength: 5000` `default: ""`
`draft.content.assetIds`	`array`Im Elternobjekt erforderlich	`maxItems: 20` `default: []`
`draft.content.assetIds[]`	`string`Optional / Element	`maxLength: 16` `pattern: "^[1-9][0-9]*$"`
`draft.content.threadsTextOnly`	`boolean`Im Elternobjekt erforderlich	`default: false`
`draft.content.instagramMode`	`string`Im Elternobjekt erforderlich	`enum: ["IMAGE","REELS","CAROUSEL","STORY_IMAGE","STORY_VIDEO"]` `default: "REELS"`
`draft.content.youtubeTitle`	`string`Im Elternobjekt erforderlich	`maxLength: 100` `default: ""`
`draft.content.youtubePrivacy`	`string`Im Elternobjekt erforderlich	`enum: ["private","unlisted","public"]` `default: "private"`
`draft.content.youtubeSynthetic`	`boolean`Im Elternobjekt erforderlich	`default: false`
`draft.content.youtubeCategoryId`	`string`Im Elternobjekt erforderlich	`maxLength: 32` `default: ""`
`draft.content.youtubeShort`	`boolean`Im Elternobjekt erforderlich	`default: false`
`draft.content.linkUrl`	`string`Im Elternobjekt erforderlich	`maxLength: 2048` `default: ""`
`draft.content.scheduledAt`	`string`Im Elternobjekt erforderlich	`maxLength: 64` `default: ""`
`draft.content.displayTimezone`	`string`Im Elternobjekt erforderlich	`minLength: 1` `maxLength: 128` `default: "UTC"`
`draft.content.publishNow`	`boolean`Im Elternobjekt erforderlich	`default: false`
`draft.content.destinationOverrides`	`object`Im Elternobjekt erforderlich	`default: {}` `additionalProperties: {"type":"object","properties":{"caption":{"type":"string","maxLength":5000},"scheduledAt":{"type":"string","maxLength":64}},"additionalProperties":false}`
`draft.content.destinationOverrides.*`	`object`Optional / Element	`additionalProperties: false`
`draft.content.destinationOverrides.*.caption`	`string`Optional / Element	`maxLength: 5000`
`draft.content.destinationOverrides.*.scheduledAt`	`string`Optional / Element	`maxLength: 64`
`draft.content.expiresAt`	`string`Im Elternobjekt erforderlich	`maxLength: 64` `default: ""`
`draft.created_by`	`string \| null`Im Elternobjekt erforderlich	—
`draft.created_by`anyOf 1	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`draft.created_by`anyOf 2	`null`Im Elternobjekt erforderlich	—
`draft.updated_by`	`string \| null`Im Elternobjekt erforderlich	—
`draft.updated_by`anyOf 1	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`draft.updated_by`anyOf 2	`null`Im Elternobjekt erforderlich	—
`draft.created_at`	`string`Im Elternobjekt erforderlich	`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`Im Elternobjekt erforderlich	`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`Im Elternobjekt erforderlich	—
`draft.submission`anyOf 1	`object`Im Elternobjekt erforderlich	`additionalProperties: false`
`draft.submission.id`anyOf 1	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`draft.submission.expected_revision`anyOf 1	`integer`Im Elternobjekt erforderlich	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`draft.submission.started_at`anyOf 1	`string`Im Elternobjekt erforderlich	`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`Im Elternobjekt erforderlich	—
`draft.submission.receipt`anyOf 1 / anyOf 1	`object`Im Elternobjekt erforderlich	`additionalProperties: false`
`draft.submission.receipt.batch_id`anyOf 1 / anyOf 1	`string \| null`Im Elternobjekt erforderlich	—
`draft.submission.receipt.batch_id`anyOf 1 / anyOf 1 / anyOf 1	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`draft.submission.receipt.batch_id`anyOf 1 / anyOf 1 / anyOf 2	`null`Im Elternobjekt erforderlich	—
`draft.submission.receipt.successes`anyOf 1 / anyOf 1	`array`Im Elternobjekt erforderlich	`maxItems: 50`
`draft.submission.receipt.successes[]`anyOf 1 / anyOf 1	`object`Optional / Element	`additionalProperties: false`
`draft.submission.receipt.successes[].social_account_id`anyOf 1 / anyOf 1	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`draft.submission.receipt.successes[].post_id`anyOf 1 / anyOf 1	`string`Im Elternobjekt erforderlich	`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`Im Elternobjekt erforderlich	`maxItems: 50`
`draft.submission.receipt.failures[]`anyOf 1 / anyOf 1	`object`Optional / Element	`additionalProperties: false`
`draft.submission.receipt.failures[].social_account_id`anyOf 1 / anyOf 1	`string`Im Elternobjekt erforderlich	`format: "uuid"`
`draft.submission.receipt.failures[].code`anyOf 1 / anyOf 1	`string`Im Elternobjekt erforderlich	`minLength: 1` `maxLength: 160`
`draft.submission.receipt.failures[].message`anyOf 1 / anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 2000`
`draft.submission.receipt`anyOf 1 / anyOf 2	`null`Im Elternobjekt erforderlich	—
`draft.submission`anyOf 2	`null`Im Elternobjekt erforderlich	—

Vollständiges 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
}

Beispiel eines Tool-Aufrufs

Diese Beispiele nutzen anhand der Schemas geprüfte fiktive Werte. Ersetze IDs durch autorisierte IDs, Medien durch bereite Assets und Daten durch bestätigte Veröffentlichungszeiten. Prüfe Kontoeignung vor Schreibvorgängen. Diese Seite sendet keine API-Anfragen.

{
  "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 installieren oder verbinden