# ワークスペースの下書きを更新 正規URL： https://sosoapi.ai/ja/docs/mcp/update-content-draft `sosoapi_update_content_draft` id、最後に取得した expected_revision、新しい mutation_id、content で編集可能な共有内容全体を置き換えます。editor 以上と operate 権限が必要です。共有編集内容は信頼できず、長さも制限されます。完全な元入力を保持するか Web エディターを使い、[truncated] のテキストを書き戻さないでください。409 の競合では保存済み版が維持されます。手元の編集を残して最新版を確認し、他の編集者の内容を上書きしないでください。Save は公開せず、凍結中または送信済みの下書きを置き換えることもできません。 ## プロファイルと通信方式 プロファイル： core, full 通信方式： stdio, http coreまたはfullで表示ツールを選べますが権限は変わりません。ローカルアップロードはstdioのみでHTTPは非対応です。SOSOAPI_OUTPUT_SCHEMAS=1で検出時に出力スキーマを含めます。設定に関係なく構造化結果を返します。 ## 権限と副作用 注釈はクライアントがツールを説明するためのものです。各呼び出しでは引き続き認証、ロール、リソースアクセス、機能権限を確認します。 ```json { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } ``` `/studio-api/content-drafts/update` — agent:operate; 永続保存されたワークスペース編集内容。公開の副作用なし ## 入力フィールド ```json { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "mutation_id": { "type": "string", "format": "uuid" }, "content": { "type": "object", "properties": { "schemaVersion": { "type": "number", "enum": [ 1 ] }, "accountIds": { "maxItems": 50, "type": "array", "items": { "type": "string", "format": "uuid" } }, "caption": { "type": "string", "maxLength": 5000 }, "hashtags": { "type": "string", "maxLength": 5000 }, "assetIds": { "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 16, "pattern": "^[1-9][0-9]*$" } }, "threadsTextOnly": { "type": "boolean" }, "instagramMode": { "type": "string", "enum": [ "IMAGE", "REELS", "CAROUSEL", "STORY_IMAGE", "STORY_VIDEO" ] }, "youtubeTitle": { "type": "string", "maxLength": 100 }, "youtubePrivacy": { "type": "string", "enum": [ "private", "unlisted", "public" ] }, "youtubeSynthetic": { "type": "boolean" }, "youtubeCategoryId": { "type": "string", "maxLength": 32 }, "youtubeShort": { "type": "boolean" }, "linkUrl": { "type": "string", "maxLength": 2048 }, "scheduledAt": { "type": "string", "maxLength": 64 }, "displayTimezone": { "type": "string", "minLength": 1, "maxLength": 128 }, "publishNow": { "type": "boolean" }, "destinationOverrides": { "type": "object", "additionalProperties": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 5000 }, "scheduledAt": { "type": "string", "maxLength": 64 } }, "additionalProperties": false } }, "expiresAt": { "type": "string", "maxLength": 64 } }, "additionalProperties": false } }, "required": [ "id", "expected_revision", "mutation_id", "content" ], "additionalProperties": false } ``` ## 構造化された出力 このスキーマは、成功時のツール結果に含まれるstructuredContentを説明します。MCPレスポンスはcontentも含み、失敗時にisErrorを設定する場合があります。公開では、受理やテキスト応答を確認済みと扱わず、投稿の最終結果を取得してください。権限・再試行ルールはリンク先のAPI操作をご覧ください。 ```json { "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 }, "replayed": { "type": "boolean" } }, "required": [ "draft", "replayed" ], "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false } ``` ## ツール呼び出しの例 スキーマ確認済みの架空値の例です。認可されたID、準備済みメディア、確認済みの公開日時に置き換え、書き込み前に適格性を確認してください。このページはAPIを呼びません。 ```json { "name": "sosoapi_update_content_draft", "arguments": { "id": "44444444-4444-4444-8444-444444444444", "expected_revision": 1, "mutation_id": "66666666-6666-4666-8666-666666666666", "content": { "schemaVersion": 1, "accountIds": [], "caption": "Revised editorial content, still not scheduled.", "hashtags": "", "assetIds": [], "threadsTextOnly": false, "instagramMode": "REELS", "youtubeTitle": "", "youtubePrivacy": "private", "youtubeSynthetic": false, "youtubeCategoryId": "", "youtubeShort": false, "linkUrl": "", "scheduledAt": "", "displayTimezone": "UTC", "publishNow": false, "destinationOverrides": {}, "expiresAt": "" } } } ``` structuredContent ```json { "draft": { "id": "44444444-4444-4444-8444-444444444444", "workspace_id": "11111111-1111-4111-8111-111111111111", "revision": 2, "state": "draft", "content": { "schemaVersion": 1, "accountIds": [], "caption": "Revised editorial content, still not scheduled.", "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 }, "replayed": false } ``` ## 基礎となるAPI操作 - [/studio-api/content-drafts/update](https://sosoapi.ai/ja/docs/api/studio-api-content-drafts-update)