Research und Briefings mit Quellenangaben
Einen redaktionellen Entwurf aus einer geprüften Forschungsvariante erstellen
Einen ungeplanten kanonischen Entwurf aus einer geprüften Variante erstellen; benötigt zusätzlich agent:operate. Keine Einreichung oder Veröffentlichung. Erfordert agent:research.
POST /research-api/briefs/handoffVertrag geprüft: · sha256:ab393e91e9b7f18a
Überblick
Einen ungeplanten kanonischen Entwurf aus einer geprüften Variante erstellen; benötigt zusätzlich agent:operate. Keine Einreichung oder Veröffentlichung. Erfordert agent:research.
Eine erfolgreiche HTTP-Antwort kann Annahme statt Abschluss bedeuten. Speichere bei Hintergrundarbeit die ID und prüfe dieselbe Operation bis zum Abschluss. Geplante oder angenommene Beiträge gelten erst nach Plattformbestätigung als veröffentlicht; ein Client-Timeout klärt das Ergebnis nicht.
Authentifizierung und Berechtigungen
Ein Token nutzt nur Eigentümerrechte. Jede Anfrage prüft Workspace-Mitgliedschaft, Ressourceneigentum, gewählte Workspaces und Funktionen. core und full ändern sichtbare Tools; sie erteilen keinen Zugriff.
Anfragefelder
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.
| Feld / Variante | Typ / erforderlich | Einschränkungen |
|---|---|---|
$ | objectIm Elternobjekt erforderlich |
|
workspace_id | stringIm Elternobjekt erforderlich |
|
mutation_id | stringIm Elternobjekt erforderlich |
|
brief_id | stringIm Elternobjekt erforderlich |
|
brief_revision | integerIm Elternobjekt erforderlich |
|
variant_id | stringIm Elternobjekt erforderlich |
|
variant_revision | integerIm Elternobjekt erforderlich |
|
content | objectIm Elternobjekt erforderlich |
|
content.schemaVersion | numberOptional / Element |
|
content.accountIds | arrayOptional / Element |
|
content.accountIds[] | stringOptional / Element |
|
content.caption | stringOptional / Element |
|
content.hashtags | stringOptional / Element |
|
content.assetIds | arrayOptional / Element |
|
content.assetIds[] | stringOptional / Element |
|
content.threadsTextOnly | booleanOptional / Element |
|
content.threadsOptions | objectOptional / Element |
|
content.threadsOptions.post_type | stringOptional / Element |
|
content.threadsOptions.reply_to_id | stringOptional / Element |
|
content.threadsOptions.quote_post_id | stringOptional / Element |
|
content.threadsOptions.repost_target_id | stringOptional / Element |
|
content.threadsOptions.reply_control | stringOptional / Element |
|
content.threadsOptions.enable_reply_approvals | booleanOptional / Element | — |
content.threadsOptions.link_attachment | stringOptional / Element |
|
content.threadsOptions.poll_attachment | objectOptional / Element |
|
content.threadsOptions.poll_attachment.option_a | stringIm Elternobjekt erforderlich |
|
content.threadsOptions.poll_attachment.option_b | stringIm Elternobjekt erforderlich |
|
content.threadsOptions.poll_attachment.option_c | stringOptional / Element |
|
content.threadsOptions.poll_attachment.option_d | stringOptional / Element |
|
content.threadsOptions.gif_attachment | objectOptional / Element |
|
content.threadsOptions.gif_attachment.gif_id | stringIm Elternobjekt erforderlich |
|
content.threadsOptions.gif_attachment.provider | stringIm Elternobjekt erforderlich |
|
content.threadsOptions.text_attachment | objectOptional / Element |
|
content.threadsOptions.text_attachment.plaintext | stringIm Elternobjekt erforderlich |
|
content.threadsOptions.text_attachment.link_attachment_url | stringOptional / Element |
|
content.threadsOptions.text_attachment.text_with_styling_info | arrayOptional / Element |
|
content.threadsOptions.text_attachment.text_with_styling_info[] | objectOptional / Element |
|
content.threadsOptions.text_attachment.text_with_styling_info[].offset | integerIm Elternobjekt erforderlich |
|
content.threadsOptions.text_attachment.text_with_styling_info[].length | integerIm Elternobjekt erforderlich |
|
content.threadsOptions.text_attachment.text_with_styling_info[].styling_info | arrayIm Elternobjekt erforderlich |
|
content.threadsOptions.text_attachment.text_with_styling_info[].styling_info[] | stringOptional / Element |
|
content.threadsOptions.topic_tag | stringOptional / Element |
|
content.threadsOptions.text_entities | arrayOptional / Element |
|
content.threadsOptions.text_entities[] | objectOptional / Element |
|
content.threadsOptions.text_entities[].entity_type | stringIm Elternobjekt erforderlich |
|
content.threadsOptions.text_entities[].offset | integerIm Elternobjekt erforderlich |
|
content.threadsOptions.text_entities[].length | integerIm Elternobjekt erforderlich |
|
content.threadsOptions.is_spoiler_media | booleanOptional / Element | — |
content.threadsOptions.is_ghost_post | booleanOptional / Element | — |
content.threadsOptions.location_id | stringOptional / Element |
|
content.threadsOptions.allowlisted_country_codes | arrayOptional / Element |
|
content.threadsOptions.allowlisted_country_codes[] | stringOptional / Element |
|
content.threadsOptions.crossreshare_to_ig | booleanOptional / Element | — |
content.threadsOptions.crossreshare_to_ig_dark_mode | booleanOptional / Element | — |
content.threadsOptions.auto_publish_text | booleanOptional / Element | — |
content.threadsOptions.media_options | arrayOptional / Element |
|
content.threadsOptions.media_options[] | objectOptional / Element |
|
content.threadsOptions.media_options[].asset_id | integerIm Elternobjekt erforderlich |
|
content.threadsOptions.media_options[].alt_text | stringOptional / Element |
|
content.threadsOptions.media_options[].is_spoiler_media | booleanOptional / Element | — |
content.instagramMode | stringOptional / Element |
|
content.youtubeTitle | stringOptional / Element |
|
content.youtubePrivacy | stringOptional / Element |
|
content.youtubeSynthetic | booleanOptional / Element |
|
content.youtubeCategoryId | stringOptional / Element |
|
content.youtubeShort | booleanOptional / Element |
|
content.linkUrl | stringOptional / Element |
|
content.scheduledAt | stringOptional / Element |
|
content.displayTimezone | stringOptional / Element |
|
content.publishNow | booleanOptional / Element |
|
content.destinationOverrides | objectOptional / Element |
|
content.destinationOverrides.* | objectOptional / Element |
|
content.destinationOverrides.*.caption | stringOptional / Element |
|
content.destinationOverrides.*.scheduledAt | stringOptional / Element |
|
content.expiresAt | stringOptional / Element |
|
Vollständiges JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"mutation_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"brief_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"brief_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"variant_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"variant_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"content": {
"type": "object",
"properties": {
"schemaVersion": {
"default": 1,
"type": "number",
"const": 1
},
"accountIds": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"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",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"additionalProperties": {
"type": "object",
"properties": {
"caption": {
"type": "string",
"maxLength": 5000
},
"scheduledAt": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
}
},
"expiresAt": {
"default": "",
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
}
},
"required": [
"workspace_id",
"mutation_id",
"brief_id",
"brief_revision",
"variant_id",
"variant_revision",
"content"
],
"additionalProperties": false
}Antwort und Abschluss
HTTP-Erfolgsstatus: 200. Wenn die Operation abgeschlossen ist: one committed canonical unscheduled Content Draft plus private source provenance; never submission/publication.
Eine erfolgreiche HTTP-Antwort kann Annahme statt Abschluss bedeuten. Speichere bei Hintergrundarbeit die ID und prüfe dieselbe Operation bis zum Abschluss. Geplante oder angenommene Beiträge gelten erst nach Plattformbestätigung als veröffentlicht; ein Client-Timeout klärt das Ergebnis nicht.
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.
| Feld / Variante | Typ / erforderlich | Einschränkungen |
|---|---|---|
$ | objectIm Elternobjekt erforderlich | — |
handoff | objectIm Elternobjekt erforderlich | — |
handoff.id | stringIm Elternobjekt erforderlich |
|
handoff.workspace_id | stringIm Elternobjekt erforderlich |
|
handoff.mutation_id | stringIm Elternobjekt erforderlich |
|
handoff.brief_id | stringIm Elternobjekt erforderlich |
|
handoff.brief_revision | integerIm Elternobjekt erforderlich |
|
handoff.variant | objectIm Elternobjekt erforderlich | — |
handoff.variant.id | stringIm Elternobjekt erforderlich |
|
handoff.variant.revision | integerIm Elternobjekt erforderlich |
|
handoff.variant.locale | stringIm Elternobjekt erforderlich |
|
handoff.draft_id | string | nullIm Elternobjekt erforderlich | — |
handoff.draft_idanyOf 1 | stringIm Elternobjekt erforderlich |
|
handoff.draft_idanyOf 2 | nullIm Elternobjekt erforderlich | — |
handoff.draft_revision | integerIm Elternobjekt erforderlich |
|
handoff.created_at | stringIm Elternobjekt erforderlich |
|
handoff.evidence | arrayIm Elternobjekt erforderlich |
|
handoff.evidence[] | objectOptional / Element | — |
handoff.evidence[].evidence_id | stringIm Elternobjekt erforderlich |
|
handoff.evidence[].revision | integerIm Elternobjekt erforderlich |
|
handoff.locked_finding_ids | arrayIm Elternobjekt erforderlich |
|
handoff.locked_finding_ids[] | stringOptional / Element |
|
handoff.availability | stringIm Elternobjekt erforderlich |
|
handoff.reasons | arrayIm Elternobjekt erforderlich |
|
handoff.reasons[] | stringOptional / Element |
|
handoff.method | stringIm Elternobjekt erforderlich |
|
draft | object | nullIm Elternobjekt erforderlich | — |
draftanyOf 1 | objectIm Elternobjekt erforderlich | — |
draft.idanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.workspace_idanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.revisionanyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.stateanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.contentanyOf 1 | objectIm Elternobjekt erforderlich | — |
draft.content.schemaVersionanyOf 1 | numberIm Elternobjekt erforderlich |
|
draft.content.accountIdsanyOf 1 | arrayIm Elternobjekt erforderlich |
|
draft.content.accountIds[]anyOf 1 | stringOptional / Element |
|
draft.content.captionanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.hashtagsanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.assetIdsanyOf 1 | arrayIm Elternobjekt erforderlich |
|
draft.content.assetIds[]anyOf 1 | stringOptional / Element |
|
draft.content.threadsTextOnlyanyOf 1 | booleanIm Elternobjekt erforderlich |
|
draft.content.threadsOptionsanyOf 1 | objectOptional / Element | — |
draft.content.threadsOptions.post_typeanyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.reply_to_idanyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.quote_post_idanyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.repost_target_idanyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.reply_controlanyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.enable_reply_approvalsanyOf 1 | booleanOptional / Element | — |
draft.content.threadsOptions.link_attachmentanyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.poll_attachmentanyOf 1 | objectOptional / Element | — |
draft.content.threadsOptions.poll_attachment.option_aanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.poll_attachment.option_banyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.poll_attachment.option_canyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.poll_attachment.option_danyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.gif_attachmentanyOf 1 | objectOptional / Element | — |
draft.content.threadsOptions.gif_attachment.gif_idanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.gif_attachment.provideranyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.text_attachmentanyOf 1 | objectOptional / Element | — |
draft.content.threadsOptions.text_attachment.plaintextanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.text_attachment.link_attachment_urlanyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.text_attachment.text_with_styling_infoanyOf 1 | arrayOptional / Element |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[]anyOf 1 | objectOptional / Element | — |
draft.content.threadsOptions.text_attachment.text_with_styling_info[].offsetanyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].lengthanyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].styling_infoanyOf 1 | arrayIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].styling_info[]anyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.topic_taganyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.text_entitiesanyOf 1 | arrayOptional / Element |
|
draft.content.threadsOptions.text_entities[]anyOf 1 | objectOptional / Element | — |
draft.content.threadsOptions.text_entities[].entity_typeanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.text_entities[].offsetanyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.text_entities[].lengthanyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.is_spoiler_mediaanyOf 1 | booleanOptional / Element | — |
draft.content.threadsOptions.is_ghost_postanyOf 1 | booleanOptional / Element | — |
draft.content.threadsOptions.location_idanyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.allowlisted_country_codesanyOf 1 | arrayOptional / Element |
|
draft.content.threadsOptions.allowlisted_country_codes[]anyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.crossreshare_to_iganyOf 1 | booleanOptional / Element | — |
draft.content.threadsOptions.crossreshare_to_ig_dark_modeanyOf 1 | booleanOptional / Element | — |
draft.content.threadsOptions.auto_publish_textanyOf 1 | booleanOptional / Element | — |
draft.content.threadsOptions.media_optionsanyOf 1 | arrayOptional / Element |
|
draft.content.threadsOptions.media_options[]anyOf 1 | objectOptional / Element | — |
draft.content.threadsOptions.media_options[].asset_idanyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.content.threadsOptions.media_options[].alt_textanyOf 1 | stringOptional / Element |
|
draft.content.threadsOptions.media_options[].is_spoiler_mediaanyOf 1 | booleanOptional / Element | — |
draft.content.instagramModeanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.youtubeTitleanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.youtubePrivacyanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.youtubeSyntheticanyOf 1 | booleanIm Elternobjekt erforderlich |
|
draft.content.youtubeCategoryIdanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.youtubeShortanyOf 1 | booleanIm Elternobjekt erforderlich |
|
draft.content.linkUrlanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.scheduledAtanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.displayTimezoneanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.content.publishNowanyOf 1 | booleanIm Elternobjekt erforderlich |
|
draft.content.destinationOverridesanyOf 1 | objectIm Elternobjekt erforderlich |
|
draft.content.destinationOverrides.*anyOf 1 | objectOptional / Element | — |
draft.content.destinationOverrides.*.captionanyOf 1 | stringOptional / Element |
|
draft.content.destinationOverrides.*.scheduledAtanyOf 1 | stringOptional / Element |
|
draft.content.expiresAtanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.created_byanyOf 1 | string | nullIm Elternobjekt erforderlich | — |
draft.created_byanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.created_byanyOf 1 / anyOf 2 | nullIm Elternobjekt erforderlich | — |
draft.updated_byanyOf 1 | string | nullIm Elternobjekt erforderlich | — |
draft.updated_byanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.updated_byanyOf 1 / anyOf 2 | nullIm Elternobjekt erforderlich | — |
draft.created_atanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.updated_atanyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.submissionanyOf 1 | object | nullIm Elternobjekt erforderlich | — |
draft.submissionanyOf 1 / anyOf 1 | objectIm Elternobjekt erforderlich | — |
draft.submission.idanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.submission.expected_revisionanyOf 1 / anyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.submission.started_atanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.submission.receiptanyOf 1 / anyOf 1 | object | nullIm Elternobjekt erforderlich | — |
draft.submission.receiptanyOf 1 / anyOf 1 / anyOf 1 | objectIm Elternobjekt erforderlich | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 | string | nullIm Elternobjekt erforderlich | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullIm Elternobjekt erforderlich | — |
draft.submission.receipt.successesanyOf 1 / anyOf 1 / anyOf 1 | arrayIm Elternobjekt erforderlich |
|
draft.submission.receipt.successes[]anyOf 1 / anyOf 1 / anyOf 1 | objectOptional / Element | — |
draft.submission.receipt.successes[].social_account_idanyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.submission.receipt.successes[].post_idanyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.submission.receipt.failuresanyOf 1 / anyOf 1 / anyOf 1 | arrayIm Elternobjekt erforderlich |
|
draft.submission.receipt.failures[]anyOf 1 / anyOf 1 / anyOf 1 | objectOptional / Element | — |
draft.submission.receipt.failures[].social_account_idanyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.submission.receipt.failures[].codeanyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.submission.receipt.failures[].messageanyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.submission.receiptanyOf 1 / anyOf 1 / anyOf 2 | nullIm Elternobjekt erforderlich | — |
draft.submissionanyOf 1 / anyOf 2 | nullIm Elternobjekt erforderlich | — |
draft.brand_contextanyOf 1 | object | nullOptional / Element | — |
draft.brand_contextanyOf 1 / anyOf 1 | objectOptional / Element | — |
draft.brand_context.workspace_idanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.selectionanyOf 1 / anyOf 1 | objectIm Elternobjekt erforderlich | — |
draft.brand_context.selection.profile_idanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.selection.version_idanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.selection.revisionanyOf 1 / anyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.brand_context.selection.content_digestanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.selection.context_digestanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.availabilityanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.profile_stateanyOf 1 / anyOf 1 | string | nullIm Elternobjekt erforderlich | — |
draft.brand_context.profile_stateanyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.profile_stateanyOf 1 / anyOf 1 / anyOf 2 | nullIm Elternobjekt erforderlich | — |
draft.brand_context.contentanyOf 1 / anyOf 1 | object | nullIm Elternobjekt erforderlich | — |
draft.brand_context.contentanyOf 1 / anyOf 1 / anyOf 1 | objectIm Elternobjekt erforderlich | — |
draft.brand_context.content.nameanyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.content.audienceanyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.content.voiceanyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 | string | nullIm Elternobjekt erforderlich | — |
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullIm Elternobjekt erforderlich | — |
draft.brand_context.content.preferred_termsanyOf 1 / anyOf 1 / anyOf 1 | arrayIm Elternobjekt erforderlich |
|
draft.brand_context.content.preferred_terms[]anyOf 1 / anyOf 1 / anyOf 1 | stringOptional / Element |
|
draft.brand_context.content.prohibited_termsanyOf 1 / anyOf 1 / anyOf 1 | arrayIm Elternobjekt erforderlich |
|
draft.brand_context.content.prohibited_terms[]anyOf 1 / anyOf 1 / anyOf 1 | stringOptional / Element |
|
draft.brand_context.content.locked_factsanyOf 1 / anyOf 1 / anyOf 1 | arrayIm Elternobjekt erforderlich |
|
draft.brand_context.content.locked_facts[]anyOf 1 / anyOf 1 / anyOf 1 | stringOptional / Element |
|
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 | string | nullIm Elternobjekt erforderlich | — |
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullIm Elternobjekt erforderlich | — |
draft.brand_context.contentanyOf 1 / anyOf 1 / anyOf 2 | nullIm Elternobjekt erforderlich | — |
draft.brand_context.sourcesanyOf 1 / anyOf 1 | objectIm Elternobjekt erforderlich | — |
draft.brand_context.sources.websiteanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.sources.logoanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_context.sources.own_postsanyOf 1 / anyOf 1 | objectIm Elternobjekt erforderlich | — |
draft.brand_context.sources.own_posts.selectedanyOf 1 / anyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.brand_context.sources.own_posts.availableanyOf 1 / anyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.brand_context.sources.own_posts.unavailableanyOf 1 / anyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.brand_context.sources.own_posts.erasedanyOf 1 / anyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.brand_contextanyOf 1 / anyOf 2 | nullOptional / Element | — |
draft.brand_reviewanyOf 1 | object | nullOptional / Element | — |
draft.brand_reviewanyOf 1 / anyOf 1 | objectOptional / Element | — |
draft.brand_review.rule_versionanyOf 1 / anyOf 1 | numberIm Elternobjekt erforderlich |
|
draft.brand_review.context_digestanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_review.content_digestanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_review.statusanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_review.issuesanyOf 1 / anyOf 1 | arrayIm Elternobjekt erforderlich |
|
draft.brand_review.issues[]anyOf 1 / anyOf 1 | objectOptional / Element | — |
draft.brand_review.issues[].codeanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_review.issues[].targetanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 | integer | nullIm Elternobjekt erforderlich | — |
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 / anyOf 1 | integerIm Elternobjekt erforderlich |
|
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 / anyOf 2 | nullIm Elternobjekt erforderlich | — |
draft.brand_review.issues[].messageanyOf 1 / anyOf 1 | stringIm Elternobjekt erforderlich |
|
draft.brand_reviewanyOf 1 / anyOf 2 | nullOptional / Element | — |
draftanyOf 2 | nullIm Elternobjekt erforderlich | — |
Vollständiges JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"handoff": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"mutation_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"brief_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"brief_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"variant": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"locale": {
"type": "string",
"enum": [
"en",
"zh-HK"
]
}
},
"required": [
"id",
"revision",
"locale"
]
},
"draft_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"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",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"evidence_id",
"revision"
]
}
},
"locked_finding_ids": {
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"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"
]
},
"draft": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"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",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"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"
]
},
"gif_attachment": {
"type": "object",
"properties": {
"gif_id": {
"type": "string",
"maxLength": 128
},
"provider": {
"type": "string",
"const": "GIPHY"
}
},
"required": [
"gif_id",
"provider"
]
},
"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"
]
}
}
},
"required": [
"plaintext"
]
},
"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"
]
}
},
"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"
]
}
}
}
},
"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",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"additionalProperties": {
"type": "object",
"properties": {
"caption": {
"type": "string",
"maxLength": 5000
},
"scheduledAt": {
"type": "string",
"maxLength": 64
}
}
}
},
"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"
]
},
"created_by": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"updated_by": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"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",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"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",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"successes": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"social_account_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"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"
]
}
},
"failures": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"social_account_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"code": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"message": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"social_account_id",
"code",
"message"
]
}
}
},
"required": [
"batch_id",
"successes",
"failures"
]
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"expected_revision",
"started_at",
"receipt"
]
},
{
"type": "null"
}
]
},
"brand_context": {
"anyOf": [
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"selection": {
"type": "object",
"properties": {
"profile_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"version_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"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"
]
},
"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"
]
},
{
"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"
]
}
},
"required": [
"website",
"logo",
"own_posts"
]
}
},
"required": [
"workspace_id",
"selection",
"availability",
"profile_state",
"content",
"sources"
]
},
{
"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"
]
}
}
},
"required": [
"rule_version",
"context_digest",
"content_digest",
"status",
"issues"
]
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"workspace_id",
"revision",
"state",
"content",
"created_by",
"updated_by",
"created_at",
"updated_at",
"submission"
]
},
{
"type": "null"
}
]
}
},
"required": [
"handoff",
"draft"
]
}Fehler und sichere Wiederholungen
Prüfe HTTP-Status und Antwortinhalt. Ein 400-Validierungsfehler kann einen ZodError enthalten; Handler-Fehler verwenden die Felder error, message und code. Bewahre request_id oder x-request-id zur Diagnose ohne Zugangsdaten auf. Behebe 401/403-Zugriffsfehler vor einem erneuten Versuch und beachte Retry-After bei 429. Ist ein Schreibvorgang ungewiss oder liefert 5xx, lies zuerst das bestehende Ergebnis. Verwende einen Idempotenzschlüssel nur wieder, wo dies unterstützt wird; Wiederholungen unterscheiden sich je nach Operation und garantieren keine genau einmalige Zustellung.
Anleitung zur FehlerbehebungBeispiele
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.
Setze SOSOAPI_ACCESS_TOKEN auf deinem Server auf akzeptierte Zugangsdaten dieser Operation und halte es aus Browsercode heraus. Für KI-Agenten nutze sosoapi auth login zur Browseranmeldung und lass die CLI Zugangsdaten erneuern.
request.json
{
"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": {}
}cURL
curl --request POST \
"https://gqeshlawtcexsapabaui.supabase.co/functions/v1/research-api/briefs/handoff" \
-H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data-binary @request.jsonJavaScript
// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/research-api/briefs/handoff", {
method: "POST",
headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
body: JSON.stringify({
"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": {}
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.CLI
npx sosoapi api post /research-api/briefs/handoff < request.jsonSynthetisches Antwortbeispiel
{
"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
}