Préférences de confidentialité

Fonctions nécessaires

Nécessaires à la sécurité et aux fonctions de base du site.

Toujours activées

Statistiques d’utilisation facultatives

Autoriser les statistiques d’utilisation PostHog ? Modifiez votre choix à tout moment dans le pied de page.

Autoriser aussi l’enregistrement des sessions sur ce site public

L’enregistrement des sessions montre les pages publiques et les interactions, en masquant les champs de saisie et les contenus privés. L’enregistrement dans l’application fait l’objet d’un choix distinct.

Nécessite les analyses ; la relecture du site est désactivée par défaut.

Les analyses du navigateur n’activent pas celles du compte.

La recherche se charge uniquement lorsque vous l’utilisez. Parcourez toutes les catégories ci-dessous.

Outil MCP

Créer un brouillon éditorial à partir d’une variante de recherche vérifiée

sosoapi_research_briefs_handoff

Créer un brouillon canonique non programmé à partir d’une variante vérifiée ; exige aussi agent:operate. Aucune soumission ou publication. Exige agent:research.

Lire en Markdown

Profils et transports

Profils : full · Transports : stdio, http

Choisissez core ou full pour définir les outils visibles du client ; cela ne change pas ses autorisations. Le téléversement local nécessite stdio et n’est pas disponible sur HTTP. Définissez SOSOAPI_OUTPUT_SCHEMAS=1 pour inclure les schémas de sortie à la découverte. Les outils renvoient des résultats structurés avec ou sans ce réglage.

Autorisations et effets de bord

Les annotations aident les clients à décrire un outil. Chaque appel vérifie toujours l’authentification, le rôle, l’accès aux ressources et les capacités accordées de l’utilisateur.

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}
  • /research-api/briefs/handoff: agent:research · un brouillon de contenu canonique non programmé enregistré, avec provenance privée des sources ; jamais une soumission/publication

Champs d’entrée

Requis signifie requis dans l’objet parent et la branche sélectionnée. Un enfant requis ne rend pas obligatoire un parent facultatif. Les règles et noms de champs ci-dessous proviennent du contrat.

Champs d’entrée
Champ / brancheType / requisContraintes
$objectRequis dans le parent
  • additionalProperties: false
workspace_idstringRequis dans le parent
  • format: "uuid"
mutation_idstringRequis dans le parent
  • format: "uuid"
brief_idstringRequis dans le parent
  • format: "uuid"
brief_revisionintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
variant_idstringRequis dans le parent
  • format: "uuid"
variant_revisionintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
contentobjectRequis dans le parent
  • additionalProperties: false
content.schemaVersionnumberFacultatif / élément
  • enum: [1]
content.accountIdsarrayFacultatif / élément
  • maxItems: 50
content.accountIds[]stringFacultatif / élément
  • format: "uuid"
content.captionstringFacultatif / élément
  • maxLength: 5000
content.hashtagsstringFacultatif / élément
  • maxLength: 5000
content.assetIdsarrayFacultatif / élément
  • maxItems: 20
content.assetIds[]stringFacultatif / élément
  • maxLength: 16
  • pattern: "^[1-9][0-9]*$"
content.threadsTextOnlybooleanFacultatif / élément—
content.threadsOptionsobjectFacultatif / élément
  • additionalProperties: false
content.threadsOptions.post_typestringFacultatif / élément
  • enum: ["TEXT","IMAGE","VIDEO","CAROUSEL","REPOST"]
content.threadsOptions.reply_to_idstringFacultatif / élément
  • maxLength: 128
content.threadsOptions.quote_post_idstringFacultatif / élément
  • maxLength: 128
content.threadsOptions.repost_target_idstringFacultatif / élément
  • maxLength: 128
content.threadsOptions.reply_controlstringFacultatif / élément
  • enum: ["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"]
content.threadsOptions.enable_reply_approvalsbooleanFacultatif / élément—
content.threadsOptions.link_attachmentstringFacultatif / élément
  • maxLength: 2048
content.threadsOptions.poll_attachmentobjectFacultatif / élément
  • additionalProperties: false
content.threadsOptions.poll_attachment.option_astringRequis dans le parent
  • maxLength: 25
content.threadsOptions.poll_attachment.option_bstringRequis dans le parent
  • maxLength: 25
content.threadsOptions.poll_attachment.option_cstringFacultatif / élément
  • maxLength: 25
content.threadsOptions.poll_attachment.option_dstringFacultatif / élément
  • maxLength: 25
content.threadsOptions.gif_attachmentobjectFacultatif / élément
  • additionalProperties: false
content.threadsOptions.gif_attachment.gif_idstringRequis dans le parent
  • maxLength: 128
content.threadsOptions.gif_attachment.providerstringRequis dans le parent
  • enum: ["GIPHY"]
content.threadsOptions.text_attachmentobjectFacultatif / élément
  • additionalProperties: false
content.threadsOptions.text_attachment.plaintextstringRequis dans le parent
  • maxLength: 10000
content.threadsOptions.text_attachment.link_attachment_urlstringFacultatif / élément
  • maxLength: 2048
content.threadsOptions.text_attachment.text_with_styling_infoarrayFacultatif / élément
  • maxItems: 100
content.threadsOptions.text_attachment.text_with_styling_info[]objectFacultatif / élément
  • additionalProperties: false
content.threadsOptions.text_attachment.text_with_styling_info[].offsetintegerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
content.threadsOptions.text_attachment.text_with_styling_info[].lengthintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
content.threadsOptions.text_attachment.text_with_styling_info[].styling_infoarrayRequis dans le parent
  • minItems: 1
content.threadsOptions.text_attachment.text_with_styling_info[].styling_info[]stringFacultatif / élément
  • enum: ["bold","italic","highlight","underline","strikethrough"]
content.threadsOptions.topic_tagstringFacultatif / élément
  • maxLength: 50
content.threadsOptions.text_entitiesarrayFacultatif / élément
  • maxItems: 10
content.threadsOptions.text_entities[]objectFacultatif / élément
  • additionalProperties: false
content.threadsOptions.text_entities[].entity_typestringRequis dans le parent
  • enum: ["SPOILER","spoiler"]
content.threadsOptions.text_entities[].offsetintegerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
content.threadsOptions.text_entities[].lengthintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
content.threadsOptions.is_spoiler_mediabooleanFacultatif / élément—
content.threadsOptions.is_ghost_postbooleanFacultatif / élément—
content.threadsOptions.location_idstringFacultatif / élément
  • maxLength: 128
content.threadsOptions.allowlisted_country_codesarrayFacultatif / élément
  • minItems: 1
  • maxItems: 249
content.threadsOptions.allowlisted_country_codes[]stringFacultatif / élément
  • pattern: "^[A-Z]{2}$"
content.threadsOptions.crossreshare_to_igbooleanFacultatif / élément—
content.threadsOptions.crossreshare_to_ig_dark_modebooleanFacultatif / élément—
content.threadsOptions.auto_publish_textbooleanFacultatif / élément—
content.threadsOptions.media_optionsarrayFacultatif / élément
  • maxItems: 20
content.threadsOptions.media_options[]objectFacultatif / élément
  • additionalProperties: false
content.threadsOptions.media_options[].asset_idintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
content.threadsOptions.media_options[].alt_textstringFacultatif / élément
  • minLength: 1
  • maxLength: 1000
content.threadsOptions.media_options[].is_spoiler_mediabooleanFacultatif / élément—
content.instagramModestringFacultatif / élément
  • enum: ["IMAGE","REELS","CAROUSEL","STORY_IMAGE","STORY_VIDEO"]
content.youtubeTitlestringFacultatif / élément
  • maxLength: 100
content.youtubePrivacystringFacultatif / élément
  • enum: ["private","unlisted","public"]
content.youtubeSyntheticbooleanFacultatif / élément—
content.youtubeCategoryIdstringFacultatif / élément
  • maxLength: 32
content.youtubeShortbooleanFacultatif / élément—
content.linkUrlstringFacultatif / élément
  • maxLength: 2048
content.scheduledAtstringFacultatif / élément
  • maxLength: 64
content.displayTimezonestringFacultatif / élément
  • minLength: 1
  • maxLength: 128
content.publishNowbooleanFacultatif / élément—
content.destinationOverridesobjectFacultatif / élément
  • additionalProperties: {"type":"object","properties":{"caption":{"type":"string","maxLength":5000},"scheduledAt":{"type":"string","maxLength":64}},"additionalProperties":false}
content.destinationOverrides.*objectFacultatif / élément
  • additionalProperties: false
content.destinationOverrides.*.captionstringFacultatif / élément
  • maxLength: 5000
content.destinationOverrides.*.scheduledAtstringFacultatif / élément
  • maxLength: 64
content.expiresAtstringFacultatif / élément
  • maxLength: 64
JSON Schema complet
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "$ref": "#/$defs/s1"
    },
    "mutation_id": {
      "$ref": "#/$defs/s1"
    },
    "brief_id": {
      "$ref": "#/$defs/s1"
    },
    "brief_revision": {
      "$ref": "#/$defs/s0"
    },
    "variant_id": {
      "$ref": "#/$defs/s1"
    },
    "variant_revision": {
      "$ref": "#/$defs/s0"
    },
    "content": {
      "type": "object",
      "properties": {
        "schemaVersion": {
          "type": "number",
          "enum": [
            1
          ]
        },
        "accountIds": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "$ref": "#/$defs/s1"
          }
        },
        "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"
        },
        "threadsOptions": {
          "type": "object",
          "properties": {
            "post_type": {
              "type": "string",
              "enum": [
                "TEXT",
                "IMAGE",
                "VIDEO",
                "CAROUSEL",
                "REPOST"
              ]
            },
            "reply_to_id": {
              "$ref": "#/$defs/s2"
            },
            "quote_post_id": {
              "$ref": "#/$defs/s2"
            },
            "repost_target_id": {
              "$ref": "#/$defs/s2"
            },
            "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": {
                  "$ref": "#/$defs/s4"
                },
                "option_b": {
                  "$ref": "#/$defs/s4"
                },
                "option_c": {
                  "$ref": "#/$defs/s4"
                },
                "option_d": {
                  "$ref": "#/$defs/s4"
                }
              },
              "required": [
                "option_a",
                "option_b"
              ],
              "additionalProperties": false
            },
            "gif_attachment": {
              "type": "object",
              "properties": {
                "gif_id": {
                  "$ref": "#/$defs/s2"
                },
                "provider": {
                  "type": "string",
                  "enum": [
                    "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": {
                        "$ref": "#/$defs/s3"
                      },
                      "length": {
                        "$ref": "#/$defs/s0"
                      },
                      "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": {
                    "$ref": "#/$defs/s3"
                  },
                  "length": {
                    "$ref": "#/$defs/s0"
                  }
                },
                "required": [
                  "entity_type",
                  "offset",
                  "length"
                ],
                "additionalProperties": false
              }
            },
            "is_spoiler_media": {
              "type": "boolean"
            },
            "is_ghost_post": {
              "type": "boolean"
            },
            "location_id": {
              "$ref": "#/$defs/s2"
            },
            "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": {
                    "$ref": "#/$defs/s0"
                  },
                  "alt_text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "is_spoiler_media": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "asset_id"
                ],
                "additionalProperties": false
              }
            }
          },
          "additionalProperties": false
        },
        "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": [
    "workspace_id",
    "mutation_id",
    "brief_id",
    "brief_revision",
    "variant_id",
    "variant_revision",
    "content"
  ],
  "additionalProperties": false,
  "$defs": {
    "s0": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "s1": {
      "type": "string",
      "format": "uuid"
    },
    "s2": {
      "type": "string",
      "maxLength": 128
    },
    "s3": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "s4": {
      "type": "string",
      "maxLength": 25
    }
  }
}

Sortie structurée

Ce schéma décrit structuredContent dans un résultat d’outil réussi. La réponse MCP contient aussi content et peut définir isError en cas d’échec. Pour publier, lisez le résultat final de la publication plutôt que de considérer une requête acceptée ou une réponse texte comme une confirmation. L’opération API liée explique les autorisations et règles de nouvelle tentative.

Requis signifie requis dans l’objet parent et la branche sélectionnée. Un enfant requis ne rend pas obligatoire un parent facultatif. Les règles et noms de champs ci-dessous proviennent du contrat.

Sortie structurée
Champ / brancheType / requisContraintes
$objectRequis dans le parent
  • additionalProperties: false
handoffobjectRequis dans le parent
  • additionalProperties: false
handoff.idstringRequis dans le parent
  • format: "uuid"
handoff.workspace_idstringRequis dans le parent
  • format: "uuid"
handoff.mutation_idstringRequis dans le parent
  • format: "uuid"
handoff.brief_idstringRequis dans le parent
  • format: "uuid"
handoff.brief_revisionintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
handoff.variantobjectRequis dans le parent
  • additionalProperties: false
handoff.variant.idstringRequis dans le parent
  • format: "uuid"
handoff.variant.revisionintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
handoff.variant.localestringRequis dans le parent
  • enum: ["en","zh-HK"]
handoff.draft_idstring | nullRequis dans le parent—
handoff.draft_idanyOf 1stringRequis dans le parent
  • format: "uuid"
handoff.draft_idanyOf 2nullRequis dans le parent—
handoff.draft_revisionintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
handoff.created_atstringRequis dans le parent
  • 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)))$"
handoff.evidencearrayRequis dans le parent
  • maxItems: 500
handoff.evidence[]objectFacultatif / élément
  • additionalProperties: false
handoff.evidence[].evidence_idstringRequis dans le parent
  • format: "uuid"
handoff.evidence[].revisionintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
handoff.locked_finding_idsarrayRequis dans le parent
  • maxItems: 100
handoff.locked_finding_ids[]stringFacultatif / élément
  • format: "uuid"
handoff.availabilitystringRequis dans le parent
  • enum: ["available","stale","unavailable"]
handoff.reasonsarrayRequis dans le parent
  • maxItems: 6
handoff.reasons[]stringFacultatif / élément
  • enum: ["source_unavailable","source_changed","brief_changed","variant_changed","draft_changed","draft_unavailable","not_reviewed"]
handoff.methodstringRequis dans le parent
  • const: "reviewed_manual_handoff/v1"
draftobject | nullRequis dans le parent—
draftanyOf 1objectRequis dans le parent
  • additionalProperties: false
draft.idanyOf 1stringRequis dans le parent
  • format: "uuid"
draft.workspace_idanyOf 1stringRequis dans le parent
  • format: "uuid"
draft.revisionanyOf 1integerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
draft.stateanyOf 1stringRequis dans le parent
  • enum: ["draft","submitting","submitted"]
draft.contentanyOf 1objectRequis dans le parent
  • additionalProperties: false
draft.content.schemaVersionanyOf 1numberRequis dans le parent
  • const: 1
  • default: 1
draft.content.accountIdsanyOf 1arrayRequis dans le parent
  • maxItems: 50
  • default: []
draft.content.accountIds[]anyOf 1stringFacultatif / élément
  • format: "uuid"
draft.content.captionanyOf 1stringRequis dans le parent
  • maxLength: 5000
  • default: ""
draft.content.hashtagsanyOf 1stringRequis dans le parent
  • maxLength: 5000
  • default: ""
draft.content.assetIdsanyOf 1arrayRequis dans le parent
  • maxItems: 20
  • default: []
draft.content.assetIds[]anyOf 1stringFacultatif / élément
  • maxLength: 16
  • pattern: "^[1-9][0-9]*$"
draft.content.threadsTextOnlyanyOf 1booleanRequis dans le parent
  • default: false
draft.content.threadsOptionsanyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.content.threadsOptions.post_typeanyOf 1stringFacultatif / élément
  • enum: ["TEXT","IMAGE","VIDEO","CAROUSEL","REPOST"]
draft.content.threadsOptions.reply_to_idanyOf 1stringFacultatif / élément
  • maxLength: 128
draft.content.threadsOptions.quote_post_idanyOf 1stringFacultatif / élément
  • maxLength: 128
draft.content.threadsOptions.repost_target_idanyOf 1stringFacultatif / élément
  • maxLength: 128
draft.content.threadsOptions.reply_controlanyOf 1stringFacultatif / élément
  • enum: ["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"]
draft.content.threadsOptions.enable_reply_approvalsanyOf 1booleanFacultatif / élément—
draft.content.threadsOptions.link_attachmentanyOf 1stringFacultatif / élément
  • maxLength: 2048
draft.content.threadsOptions.poll_attachmentanyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.content.threadsOptions.poll_attachment.option_aanyOf 1stringRequis dans le parent
  • maxLength: 25
draft.content.threadsOptions.poll_attachment.option_banyOf 1stringRequis dans le parent
  • maxLength: 25
draft.content.threadsOptions.poll_attachment.option_canyOf 1stringFacultatif / élément
  • maxLength: 25
draft.content.threadsOptions.poll_attachment.option_danyOf 1stringFacultatif / élément
  • maxLength: 25
draft.content.threadsOptions.gif_attachmentanyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.content.threadsOptions.gif_attachment.gif_idanyOf 1stringRequis dans le parent
  • maxLength: 128
draft.content.threadsOptions.gif_attachment.provideranyOf 1stringRequis dans le parent
  • const: "GIPHY"
draft.content.threadsOptions.text_attachmentanyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.content.threadsOptions.text_attachment.plaintextanyOf 1stringRequis dans le parent
  • maxLength: 10000
draft.content.threadsOptions.text_attachment.link_attachment_urlanyOf 1stringFacultatif / élément
  • maxLength: 2048
draft.content.threadsOptions.text_attachment.text_with_styling_infoanyOf 1arrayFacultatif / élément
  • maxItems: 100
draft.content.threadsOptions.text_attachment.text_with_styling_info[]anyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.content.threadsOptions.text_attachment.text_with_styling_info[].offsetanyOf 1integerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
draft.content.threadsOptions.text_attachment.text_with_styling_info[].lengthanyOf 1integerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
draft.content.threadsOptions.text_attachment.text_with_styling_info[].styling_infoanyOf 1arrayRequis dans le parent
  • minItems: 1
draft.content.threadsOptions.text_attachment.text_with_styling_info[].styling_info[]anyOf 1stringFacultatif / élément
  • enum: ["bold","italic","highlight","underline","strikethrough"]
draft.content.threadsOptions.topic_taganyOf 1stringFacultatif / élément
  • maxLength: 50
draft.content.threadsOptions.text_entitiesanyOf 1arrayFacultatif / élément
  • maxItems: 10
draft.content.threadsOptions.text_entities[]anyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.content.threadsOptions.text_entities[].entity_typeanyOf 1stringRequis dans le parent
  • enum: ["SPOILER","spoiler"]
draft.content.threadsOptions.text_entities[].offsetanyOf 1integerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
draft.content.threadsOptions.text_entities[].lengthanyOf 1integerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
draft.content.threadsOptions.is_spoiler_mediaanyOf 1booleanFacultatif / élément—
draft.content.threadsOptions.is_ghost_postanyOf 1booleanFacultatif / élément—
draft.content.threadsOptions.location_idanyOf 1stringFacultatif / élément
  • maxLength: 128
draft.content.threadsOptions.allowlisted_country_codesanyOf 1arrayFacultatif / élément
  • minItems: 1
  • maxItems: 249
draft.content.threadsOptions.allowlisted_country_codes[]anyOf 1stringFacultatif / élément
  • pattern: "^[A-Z]{2}$"
draft.content.threadsOptions.crossreshare_to_iganyOf 1booleanFacultatif / élément—
draft.content.threadsOptions.crossreshare_to_ig_dark_modeanyOf 1booleanFacultatif / élément—
draft.content.threadsOptions.auto_publish_textanyOf 1booleanFacultatif / élément—
draft.content.threadsOptions.media_optionsanyOf 1arrayFacultatif / élément
  • maxItems: 20
draft.content.threadsOptions.media_options[]anyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.content.threadsOptions.media_options[].asset_idanyOf 1integerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
draft.content.threadsOptions.media_options[].alt_textanyOf 1stringFacultatif / élément
  • minLength: 1
  • maxLength: 1000
draft.content.threadsOptions.media_options[].is_spoiler_mediaanyOf 1booleanFacultatif / élément—
draft.content.instagramModeanyOf 1stringRequis dans le parent
  • enum: ["IMAGE","REELS","CAROUSEL","STORY_IMAGE","STORY_VIDEO"]
  • default: "REELS"
draft.content.youtubeTitleanyOf 1stringRequis dans le parent
  • maxLength: 100
  • default: ""
draft.content.youtubePrivacyanyOf 1stringRequis dans le parent
  • enum: ["private","unlisted","public"]
  • default: "private"
draft.content.youtubeSyntheticanyOf 1booleanRequis dans le parent
  • default: false
draft.content.youtubeCategoryIdanyOf 1stringRequis dans le parent
  • maxLength: 32
  • default: ""
draft.content.youtubeShortanyOf 1booleanRequis dans le parent
  • default: false
draft.content.linkUrlanyOf 1stringRequis dans le parent
  • maxLength: 2048
  • default: ""
draft.content.scheduledAtanyOf 1stringRequis dans le parent
  • maxLength: 64
  • default: ""
draft.content.displayTimezoneanyOf 1stringRequis dans le parent
  • minLength: 1
  • maxLength: 128
  • default: "UTC"
draft.content.publishNowanyOf 1booleanRequis dans le parent
  • default: false
draft.content.destinationOverridesanyOf 1objectRequis dans le parent
  • default: {}
  • additionalProperties: {"type":"object","properties":{"caption":{"type":"string","maxLength":5000},"scheduledAt":{"type":"string","maxLength":64}},"additionalProperties":false}
draft.content.destinationOverrides.*anyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.content.destinationOverrides.*.captionanyOf 1stringFacultatif / élément
  • maxLength: 5000
draft.content.destinationOverrides.*.scheduledAtanyOf 1stringFacultatif / élément
  • maxLength: 64
draft.content.expiresAtanyOf 1stringRequis dans le parent
  • maxLength: 64
  • default: ""
draft.created_byanyOf 1string | nullRequis dans le parent—
draft.created_byanyOf 1 / anyOf 1stringRequis dans le parent
  • format: "uuid"
draft.created_byanyOf 1 / anyOf 2nullRequis dans le parent—
draft.updated_byanyOf 1string | nullRequis dans le parent—
draft.updated_byanyOf 1 / anyOf 1stringRequis dans le parent
  • format: "uuid"
draft.updated_byanyOf 1 / anyOf 2nullRequis dans le parent—
draft.created_atanyOf 1stringRequis dans le parent
  • 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_atanyOf 1stringRequis dans le parent
  • 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.submissionanyOf 1object | nullRequis dans le parent—
draft.submissionanyOf 1 / anyOf 1objectRequis dans le parent
  • additionalProperties: false
draft.submission.idanyOf 1 / anyOf 1stringRequis dans le parent
  • format: "uuid"
draft.submission.expected_revisionanyOf 1 / anyOf 1integerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
draft.submission.started_atanyOf 1 / anyOf 1stringRequis dans le parent
  • 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.receiptanyOf 1 / anyOf 1object | nullRequis dans le parent—
draft.submission.receiptanyOf 1 / anyOf 1 / anyOf 1objectRequis dans le parent
  • additionalProperties: false
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1string | nullRequis dans le parent—
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • format: "uuid"
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2nullRequis dans le parent—
draft.submission.receipt.successesanyOf 1 / anyOf 1 / anyOf 1arrayRequis dans le parent
  • maxItems: 50
draft.submission.receipt.successes[]anyOf 1 / anyOf 1 / anyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.submission.receipt.successes[].social_account_idanyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • format: "uuid"
draft.submission.receipt.successes[].post_idanyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • 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.failuresanyOf 1 / anyOf 1 / anyOf 1arrayRequis dans le parent
  • maxItems: 50
draft.submission.receipt.failures[]anyOf 1 / anyOf 1 / anyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.submission.receipt.failures[].social_account_idanyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • format: "uuid"
draft.submission.receipt.failures[].codeanyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • minLength: 1
  • maxLength: 160
draft.submission.receipt.failures[].messageanyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • maxLength: 2000
draft.submission.receiptanyOf 1 / anyOf 1 / anyOf 2nullRequis dans le parent—
draft.submissionanyOf 1 / anyOf 2nullRequis dans le parent—
draft.brand_contextanyOf 1object | nullFacultatif / élément—
draft.brand_contextanyOf 1 / anyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.brand_context.workspace_idanyOf 1 / anyOf 1stringRequis dans le parent
  • format: "uuid"
draft.brand_context.selectionanyOf 1 / anyOf 1objectRequis dans le parent
  • additionalProperties: false
draft.brand_context.selection.profile_idanyOf 1 / anyOf 1stringRequis dans le parent
  • format: "uuid"
draft.brand_context.selection.version_idanyOf 1 / anyOf 1stringRequis dans le parent
  • format: "uuid"
draft.brand_context.selection.revisionanyOf 1 / anyOf 1integerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
draft.brand_context.selection.content_digestanyOf 1 / anyOf 1stringRequis dans le parent
  • pattern: "^[a-f0-9]{64}$"
draft.brand_context.selection.context_digestanyOf 1 / anyOf 1stringRequis dans le parent
  • pattern: "^[a-f0-9]{64}$"
draft.brand_context.availabilityanyOf 1 / anyOf 1stringRequis dans le parent
  • enum: ["available","missing"]
draft.brand_context.profile_stateanyOf 1 / anyOf 1string | nullRequis dans le parent—
draft.brand_context.profile_stateanyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • enum: ["active","archived"]
draft.brand_context.profile_stateanyOf 1 / anyOf 1 / anyOf 2nullRequis dans le parent—
draft.brand_context.contentanyOf 1 / anyOf 1object | nullRequis dans le parent—
draft.brand_context.contentanyOf 1 / anyOf 1 / anyOf 1objectRequis dans le parent
  • additionalProperties: false
draft.brand_context.content.nameanyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • maxLength: 120
draft.brand_context.content.audienceanyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • maxLength: 2000
draft.brand_context.content.voiceanyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • maxLength: 2000
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1string | nullRequis dans le parent—
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • minLength: 1
  • maxLength: 64
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2nullRequis dans le parent—
draft.brand_context.content.preferred_termsanyOf 1 / anyOf 1 / anyOf 1arrayRequis dans le parent
  • maxItems: 50
draft.brand_context.content.preferred_terms[]anyOf 1 / anyOf 1 / anyOf 1stringFacultatif / élément
  • minLength: 1
  • maxLength: 120
draft.brand_context.content.prohibited_termsanyOf 1 / anyOf 1 / anyOf 1arrayRequis dans le parent
  • maxItems: 50
draft.brand_context.content.prohibited_terms[]anyOf 1 / anyOf 1 / anyOf 1stringFacultatif / élément
  • minLength: 1
  • maxLength: 120
draft.brand_context.content.locked_factsanyOf 1 / anyOf 1 / anyOf 1arrayRequis dans le parent
  • maxItems: 50
draft.brand_context.content.locked_facts[]anyOf 1 / anyOf 1 / anyOf 1stringFacultatif / élément
  • minLength: 1
  • maxLength: 500
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1string | nullRequis dans le parent—
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1stringRequis dans le parent
  • maxLength: 1000
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2nullRequis dans le parent—
draft.brand_context.contentanyOf 1 / anyOf 1 / anyOf 2nullRequis dans le parent—
draft.brand_context.sourcesanyOf 1 / anyOf 1objectRequis dans le parent
  • additionalProperties: false
draft.brand_context.sources.websiteanyOf 1 / anyOf 1stringRequis dans le parent
  • enum: ["available","not_available"]
draft.brand_context.sources.logoanyOf 1 / anyOf 1stringRequis dans le parent
  • enum: ["none","present","missing"]
draft.brand_context.sources.own_postsanyOf 1 / anyOf 1objectRequis dans le parent
  • additionalProperties: false
draft.brand_context.sources.own_posts.selectedanyOf 1 / anyOf 1integerRequis dans le parent
  • minimum: 0
  • maximum: 10
draft.brand_context.sources.own_posts.availableanyOf 1 / anyOf 1integerRequis dans le parent
  • minimum: 0
  • maximum: 10
draft.brand_context.sources.own_posts.unavailableanyOf 1 / anyOf 1integerRequis dans le parent
  • minimum: 0
  • maximum: 10
draft.brand_context.sources.own_posts.erasedanyOf 1 / anyOf 1integerRequis dans le parent
  • minimum: 0
  • maximum: 10
draft.brand_contextanyOf 1 / anyOf 2nullFacultatif / élément—
draft.brand_reviewanyOf 1object | nullFacultatif / élément—
draft.brand_reviewanyOf 1 / anyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.brand_review.rule_versionanyOf 1 / anyOf 1numberRequis dans le parent
  • const: 1
draft.brand_review.context_digestanyOf 1 / anyOf 1stringRequis dans le parent
  • pattern: "^[a-f0-9]{64}$"
draft.brand_review.content_digestanyOf 1 / anyOf 1stringRequis dans le parent
  • pattern: "^[a-f0-9]{64}$"
draft.brand_review.statusanyOf 1 / anyOf 1stringRequis dans le parent
  • enum: ["clear","attention","unavailable"]
draft.brand_review.issuesanyOf 1 / anyOf 1arrayRequis dans le parent
  • maxItems: 5151
draft.brand_review.issues[]anyOf 1 / anyOf 1objectFacultatif / élément
  • additionalProperties: false
draft.brand_review.issues[].codeanyOf 1 / anyOf 1stringRequis dans le parent
  • enum: ["prohibited_term","locked_fact_missing","conflicting_rule","context_unavailable"]
draft.brand_review.issues[].targetanyOf 1 / anyOf 1stringRequis dans le parent
  • minLength: 1
  • maxLength: 80
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1integer | nullRequis dans le parent—
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 / anyOf 1integerRequis dans le parent
  • minimum: 0
  • maximum: 49
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 / anyOf 2nullRequis dans le parent—
draft.brand_review.issues[].messageanyOf 1 / anyOf 1stringRequis dans le parent
  • minLength: 1
  • maxLength: 240
draft.brand_reviewanyOf 1 / anyOf 2nullFacultatif / élément—
draftanyOf 2nullRequis dans le parent—
JSON Schema complet
{
  "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
}

Exemple d’appel d’outil

Ces exemples utilisent des valeurs fictives vérifiées contre les schémas. Remplacez les identifiants par ceux que vous êtes autorisé à utiliser, les médias par des ressources prêtes et les dates par l’heure confirmée. Vérifiez l’éligibilité du compte avant toute écriture. Cette page n’envoie aucune requête API.

{
  "name": "sosoapi_research_briefs_handoff",
  "arguments": {
    "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",
    "variant_revision": 1,
    "content": {}
  }
}

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
}
Installer ou connecter MCP