Forskning og notater med kildehenvisninger
Opprett et redaksjonelt utkast fra en gjennomgått forskningsvariant
Opprett et kanonisk utkast uten tidsplan fra en gjennomgått variant; krever også agent:operate. Ingen innsending eller publisering. Krever agent:research.
POST /research-api/briefs/handoffKontrakt gjennomgått: · sha256:ab393e91e9b7f18a
Oversikt
Opprett et kanonisk utkast uten tidsplan fra en gjennomgått variant; krever også agent:operate. Ingen innsending eller publisering. Krever agent:research.
Et vellykket HTTP-svar kan bety at en forespørsel er akseptert fremfor fullført. For bakgrunnsarbeid, lagre returnert ID og kontroller samme operasjon til den er ferdig. Et planlagt eller akseptert innlegg er først publisert når plattformen bekrefter det; et klienttidsavbrudd fastslår ikke resultatet.
Autentisering og tillatelser
Et token kan bare bruke rettighetene eieren har. Hver forespørsel kontrollerer arbeidsområdemedlemskap, ressurseierskap, valgte arbeidsområder og gitte funksjoner. Profilene core og full endrer hvilke verktøy som vises; de gir ikke tilgang.
Forespørselsfelter
Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.
| Felt / gren | Type / påkrevd | Begrensninger |
|---|---|---|
$ | objectPåkrevd i forelder |
|
workspace_id | stringPåkrevd i forelder |
|
mutation_id | stringPåkrevd i forelder |
|
brief_id | stringPåkrevd i forelder |
|
brief_revision | integerPåkrevd i forelder |
|
variant_id | stringPåkrevd i forelder |
|
variant_revision | integerPåkrevd i forelder |
|
content | objectPåkrevd i forelder |
|
content.schemaVersion | numberValgfritt / element |
|
content.accountIds | arrayValgfritt / element |
|
content.accountIds[] | stringValgfritt / element |
|
content.caption | stringValgfritt / element |
|
content.hashtags | stringValgfritt / element |
|
content.assetIds | arrayValgfritt / element |
|
content.assetIds[] | stringValgfritt / element |
|
content.threadsTextOnly | booleanValgfritt / element |
|
content.threadsOptions | objectValgfritt / element |
|
content.threadsOptions.post_type | stringValgfritt / element |
|
content.threadsOptions.reply_to_id | stringValgfritt / element |
|
content.threadsOptions.quote_post_id | stringValgfritt / element |
|
content.threadsOptions.repost_target_id | stringValgfritt / element |
|
content.threadsOptions.reply_control | stringValgfritt / element |
|
content.threadsOptions.enable_reply_approvals | booleanValgfritt / element | — |
content.threadsOptions.link_attachment | stringValgfritt / element |
|
content.threadsOptions.poll_attachment | objectValgfritt / element |
|
content.threadsOptions.poll_attachment.option_a | stringPåkrevd i forelder |
|
content.threadsOptions.poll_attachment.option_b | stringPåkrevd i forelder |
|
content.threadsOptions.poll_attachment.option_c | stringValgfritt / element |
|
content.threadsOptions.poll_attachment.option_d | stringValgfritt / element |
|
content.threadsOptions.gif_attachment | objectValgfritt / element |
|
content.threadsOptions.gif_attachment.gif_id | stringPåkrevd i forelder |
|
content.threadsOptions.gif_attachment.provider | stringPåkrevd i forelder |
|
content.threadsOptions.text_attachment | objectValgfritt / element |
|
content.threadsOptions.text_attachment.plaintext | stringPåkrevd i forelder |
|
content.threadsOptions.text_attachment.link_attachment_url | stringValgfritt / element |
|
content.threadsOptions.text_attachment.text_with_styling_info | arrayValgfritt / element |
|
content.threadsOptions.text_attachment.text_with_styling_info[] | objectValgfritt / element |
|
content.threadsOptions.text_attachment.text_with_styling_info[].offset | integerPåkrevd i forelder |
|
content.threadsOptions.text_attachment.text_with_styling_info[].length | integerPåkrevd i forelder |
|
content.threadsOptions.text_attachment.text_with_styling_info[].styling_info | arrayPåkrevd i forelder |
|
content.threadsOptions.text_attachment.text_with_styling_info[].styling_info[] | stringValgfritt / element |
|
content.threadsOptions.topic_tag | stringValgfritt / element |
|
content.threadsOptions.text_entities | arrayValgfritt / element |
|
content.threadsOptions.text_entities[] | objectValgfritt / element |
|
content.threadsOptions.text_entities[].entity_type | stringPåkrevd i forelder |
|
content.threadsOptions.text_entities[].offset | integerPåkrevd i forelder |
|
content.threadsOptions.text_entities[].length | integerPåkrevd i forelder |
|
content.threadsOptions.is_spoiler_media | booleanValgfritt / element | — |
content.threadsOptions.is_ghost_post | booleanValgfritt / element | — |
content.threadsOptions.location_id | stringValgfritt / element |
|
content.threadsOptions.allowlisted_country_codes | arrayValgfritt / element |
|
content.threadsOptions.allowlisted_country_codes[] | stringValgfritt / element |
|
content.threadsOptions.crossreshare_to_ig | booleanValgfritt / element | — |
content.threadsOptions.crossreshare_to_ig_dark_mode | booleanValgfritt / element | — |
content.threadsOptions.auto_publish_text | booleanValgfritt / element | — |
content.threadsOptions.media_options | arrayValgfritt / element |
|
content.threadsOptions.media_options[] | objectValgfritt / element |
|
content.threadsOptions.media_options[].asset_id | integerPåkrevd i forelder |
|
content.threadsOptions.media_options[].alt_text | stringValgfritt / element |
|
content.threadsOptions.media_options[].is_spoiler_media | booleanValgfritt / element | — |
content.instagramMode | stringValgfritt / element |
|
content.youtubeTitle | stringValgfritt / element |
|
content.youtubePrivacy | stringValgfritt / element |
|
content.youtubeSynthetic | booleanValgfritt / element |
|
content.youtubeCategoryId | stringValgfritt / element |
|
content.youtubeShort | booleanValgfritt / element |
|
content.linkUrl | stringValgfritt / element |
|
content.scheduledAt | stringValgfritt / element |
|
content.displayTimezone | stringValgfritt / element |
|
content.publishNow | booleanValgfritt / element |
|
content.destinationOverrides | objectValgfritt / element |
|
content.destinationOverrides.* | objectValgfritt / element |
|
content.destinationOverrides.*.caption | stringValgfritt / element |
|
content.destinationOverrides.*.scheduledAt | stringValgfritt / element |
|
content.expiresAt | stringValgfritt / element |
|
Fullstendig 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
}Svar og fullføring
HTTP-statuser ved suksess: 200. Når operasjonen er fullført: one committed canonical unscheduled Content Draft plus private source provenance; never submission/publication.
Et vellykket HTTP-svar kan bety at en forespørsel er akseptert fremfor fullført. For bakgrunnsarbeid, lagre returnert ID og kontroller samme operasjon til den er ferdig. Et planlagt eller akseptert innlegg er først publisert når plattformen bekrefter det; et klienttidsavbrudd fastslår ikke resultatet.
Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.
| Felt / gren | Type / påkrevd | Begrensninger |
|---|---|---|
$ | objectPåkrevd i forelder | — |
handoff | objectPåkrevd i forelder | — |
handoff.id | stringPåkrevd i forelder |
|
handoff.workspace_id | stringPåkrevd i forelder |
|
handoff.mutation_id | stringPåkrevd i forelder |
|
handoff.brief_id | stringPåkrevd i forelder |
|
handoff.brief_revision | integerPåkrevd i forelder |
|
handoff.variant | objectPåkrevd i forelder | — |
handoff.variant.id | stringPåkrevd i forelder |
|
handoff.variant.revision | integerPåkrevd i forelder |
|
handoff.variant.locale | stringPåkrevd i forelder |
|
handoff.draft_id | string | nullPåkrevd i forelder | — |
handoff.draft_idanyOf 1 | stringPåkrevd i forelder |
|
handoff.draft_idanyOf 2 | nullPåkrevd i forelder | — |
handoff.draft_revision | integerPåkrevd i forelder |
|
handoff.created_at | stringPåkrevd i forelder |
|
handoff.evidence | arrayPåkrevd i forelder |
|
handoff.evidence[] | objectValgfritt / element | — |
handoff.evidence[].evidence_id | stringPåkrevd i forelder |
|
handoff.evidence[].revision | integerPåkrevd i forelder |
|
handoff.locked_finding_ids | arrayPåkrevd i forelder |
|
handoff.locked_finding_ids[] | stringValgfritt / element |
|
handoff.availability | stringPåkrevd i forelder |
|
handoff.reasons | arrayPåkrevd i forelder |
|
handoff.reasons[] | stringValgfritt / element |
|
handoff.method | stringPåkrevd i forelder |
|
draft | object | nullPåkrevd i forelder | — |
draftanyOf 1 | objectPåkrevd i forelder | — |
draft.idanyOf 1 | stringPåkrevd i forelder |
|
draft.workspace_idanyOf 1 | stringPåkrevd i forelder |
|
draft.revisionanyOf 1 | integerPåkrevd i forelder |
|
draft.stateanyOf 1 | stringPåkrevd i forelder |
|
draft.contentanyOf 1 | objectPåkrevd i forelder | — |
draft.content.schemaVersionanyOf 1 | numberPåkrevd i forelder |
|
draft.content.accountIdsanyOf 1 | arrayPåkrevd i forelder |
|
draft.content.accountIds[]anyOf 1 | stringValgfritt / element |
|
draft.content.captionanyOf 1 | stringPåkrevd i forelder |
|
draft.content.hashtagsanyOf 1 | stringPåkrevd i forelder |
|
draft.content.assetIdsanyOf 1 | arrayPåkrevd i forelder |
|
draft.content.assetIds[]anyOf 1 | stringValgfritt / element |
|
draft.content.threadsTextOnlyanyOf 1 | booleanPåkrevd i forelder |
|
draft.content.threadsOptionsanyOf 1 | objectValgfritt / element | — |
draft.content.threadsOptions.post_typeanyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.reply_to_idanyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.quote_post_idanyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.repost_target_idanyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.reply_controlanyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.enable_reply_approvalsanyOf 1 | booleanValgfritt / element | — |
draft.content.threadsOptions.link_attachmentanyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.poll_attachmentanyOf 1 | objectValgfritt / element | — |
draft.content.threadsOptions.poll_attachment.option_aanyOf 1 | stringPåkrevd i forelder |
|
draft.content.threadsOptions.poll_attachment.option_banyOf 1 | stringPåkrevd i forelder |
|
draft.content.threadsOptions.poll_attachment.option_canyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.poll_attachment.option_danyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.gif_attachmentanyOf 1 | objectValgfritt / element | — |
draft.content.threadsOptions.gif_attachment.gif_idanyOf 1 | stringPåkrevd i forelder |
|
draft.content.threadsOptions.gif_attachment.provideranyOf 1 | stringPåkrevd i forelder |
|
draft.content.threadsOptions.text_attachmentanyOf 1 | objectValgfritt / element | — |
draft.content.threadsOptions.text_attachment.plaintextanyOf 1 | stringPåkrevd i forelder |
|
draft.content.threadsOptions.text_attachment.link_attachment_urlanyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.text_attachment.text_with_styling_infoanyOf 1 | arrayValgfritt / element |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[]anyOf 1 | objectValgfritt / element | — |
draft.content.threadsOptions.text_attachment.text_with_styling_info[].offsetanyOf 1 | integerPåkrevd i forelder |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].lengthanyOf 1 | integerPåkrevd i forelder |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].styling_infoanyOf 1 | arrayPåkrevd i forelder |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].styling_info[]anyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.topic_taganyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.text_entitiesanyOf 1 | arrayValgfritt / element |
|
draft.content.threadsOptions.text_entities[]anyOf 1 | objectValgfritt / element | — |
draft.content.threadsOptions.text_entities[].entity_typeanyOf 1 | stringPåkrevd i forelder |
|
draft.content.threadsOptions.text_entities[].offsetanyOf 1 | integerPåkrevd i forelder |
|
draft.content.threadsOptions.text_entities[].lengthanyOf 1 | integerPåkrevd i forelder |
|
draft.content.threadsOptions.is_spoiler_mediaanyOf 1 | booleanValgfritt / element | — |
draft.content.threadsOptions.is_ghost_postanyOf 1 | booleanValgfritt / element | — |
draft.content.threadsOptions.location_idanyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.allowlisted_country_codesanyOf 1 | arrayValgfritt / element |
|
draft.content.threadsOptions.allowlisted_country_codes[]anyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.crossreshare_to_iganyOf 1 | booleanValgfritt / element | — |
draft.content.threadsOptions.crossreshare_to_ig_dark_modeanyOf 1 | booleanValgfritt / element | — |
draft.content.threadsOptions.auto_publish_textanyOf 1 | booleanValgfritt / element | — |
draft.content.threadsOptions.media_optionsanyOf 1 | arrayValgfritt / element |
|
draft.content.threadsOptions.media_options[]anyOf 1 | objectValgfritt / element | — |
draft.content.threadsOptions.media_options[].asset_idanyOf 1 | integerPåkrevd i forelder |
|
draft.content.threadsOptions.media_options[].alt_textanyOf 1 | stringValgfritt / element |
|
draft.content.threadsOptions.media_options[].is_spoiler_mediaanyOf 1 | booleanValgfritt / element | — |
draft.content.instagramModeanyOf 1 | stringPåkrevd i forelder |
|
draft.content.youtubeTitleanyOf 1 | stringPåkrevd i forelder |
|
draft.content.youtubePrivacyanyOf 1 | stringPåkrevd i forelder |
|
draft.content.youtubeSyntheticanyOf 1 | booleanPåkrevd i forelder |
|
draft.content.youtubeCategoryIdanyOf 1 | stringPåkrevd i forelder |
|
draft.content.youtubeShortanyOf 1 | booleanPåkrevd i forelder |
|
draft.content.linkUrlanyOf 1 | stringPåkrevd i forelder |
|
draft.content.scheduledAtanyOf 1 | stringPåkrevd i forelder |
|
draft.content.displayTimezoneanyOf 1 | stringPåkrevd i forelder |
|
draft.content.publishNowanyOf 1 | booleanPåkrevd i forelder |
|
draft.content.destinationOverridesanyOf 1 | objectPåkrevd i forelder |
|
draft.content.destinationOverrides.*anyOf 1 | objectValgfritt / element | — |
draft.content.destinationOverrides.*.captionanyOf 1 | stringValgfritt / element |
|
draft.content.destinationOverrides.*.scheduledAtanyOf 1 | stringValgfritt / element |
|
draft.content.expiresAtanyOf 1 | stringPåkrevd i forelder |
|
draft.created_byanyOf 1 | string | nullPåkrevd i forelder | — |
draft.created_byanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.created_byanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
draft.updated_byanyOf 1 | string | nullPåkrevd i forelder | — |
draft.updated_byanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.updated_byanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
draft.created_atanyOf 1 | stringPåkrevd i forelder |
|
draft.updated_atanyOf 1 | stringPåkrevd i forelder |
|
draft.submissionanyOf 1 | object | nullPåkrevd i forelder | — |
draft.submissionanyOf 1 / anyOf 1 | objectPåkrevd i forelder | — |
draft.submission.idanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.submission.expected_revisionanyOf 1 / anyOf 1 | integerPåkrevd i forelder |
|
draft.submission.started_atanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.submission.receiptanyOf 1 / anyOf 1 | object | nullPåkrevd i forelder | — |
draft.submission.receiptanyOf 1 / anyOf 1 / anyOf 1 | objectPåkrevd i forelder | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 | string | nullPåkrevd i forelder | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
draft.submission.receipt.successesanyOf 1 / anyOf 1 / anyOf 1 | arrayPåkrevd i forelder |
|
draft.submission.receipt.successes[]anyOf 1 / anyOf 1 / anyOf 1 | objectValgfritt / element | — |
draft.submission.receipt.successes[].social_account_idanyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.submission.receipt.successes[].post_idanyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.submission.receipt.failuresanyOf 1 / anyOf 1 / anyOf 1 | arrayPåkrevd i forelder |
|
draft.submission.receipt.failures[]anyOf 1 / anyOf 1 / anyOf 1 | objectValgfritt / element | — |
draft.submission.receipt.failures[].social_account_idanyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.submission.receipt.failures[].codeanyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.submission.receipt.failures[].messageanyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.submission.receiptanyOf 1 / anyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
draft.submissionanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
draft.brand_contextanyOf 1 | object | nullValgfritt / element | — |
draft.brand_contextanyOf 1 / anyOf 1 | objectValgfritt / element | — |
draft.brand_context.workspace_idanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.selectionanyOf 1 / anyOf 1 | objectPåkrevd i forelder | — |
draft.brand_context.selection.profile_idanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.selection.version_idanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.selection.revisionanyOf 1 / anyOf 1 | integerPåkrevd i forelder |
|
draft.brand_context.selection.content_digestanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.selection.context_digestanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.availabilityanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.profile_stateanyOf 1 / anyOf 1 | string | nullPåkrevd i forelder | — |
draft.brand_context.profile_stateanyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.profile_stateanyOf 1 / anyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
draft.brand_context.contentanyOf 1 / anyOf 1 | object | nullPåkrevd i forelder | — |
draft.brand_context.contentanyOf 1 / anyOf 1 / anyOf 1 | objectPåkrevd i forelder | — |
draft.brand_context.content.nameanyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.content.audienceanyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.content.voiceanyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 | string | nullPåkrevd i forelder | — |
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
draft.brand_context.content.preferred_termsanyOf 1 / anyOf 1 / anyOf 1 | arrayPåkrevd i forelder |
|
draft.brand_context.content.preferred_terms[]anyOf 1 / anyOf 1 / anyOf 1 | stringValgfritt / element |
|
draft.brand_context.content.prohibited_termsanyOf 1 / anyOf 1 / anyOf 1 | arrayPåkrevd i forelder |
|
draft.brand_context.content.prohibited_terms[]anyOf 1 / anyOf 1 / anyOf 1 | stringValgfritt / element |
|
draft.brand_context.content.locked_factsanyOf 1 / anyOf 1 / anyOf 1 | arrayPåkrevd i forelder |
|
draft.brand_context.content.locked_facts[]anyOf 1 / anyOf 1 / anyOf 1 | stringValgfritt / element |
|
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 | string | nullPåkrevd i forelder | — |
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
draft.brand_context.contentanyOf 1 / anyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
draft.brand_context.sourcesanyOf 1 / anyOf 1 | objectPåkrevd i forelder | — |
draft.brand_context.sources.websiteanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.sources.logoanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_context.sources.own_postsanyOf 1 / anyOf 1 | objectPåkrevd i forelder | — |
draft.brand_context.sources.own_posts.selectedanyOf 1 / anyOf 1 | integerPåkrevd i forelder |
|
draft.brand_context.sources.own_posts.availableanyOf 1 / anyOf 1 | integerPåkrevd i forelder |
|
draft.brand_context.sources.own_posts.unavailableanyOf 1 / anyOf 1 | integerPåkrevd i forelder |
|
draft.brand_context.sources.own_posts.erasedanyOf 1 / anyOf 1 | integerPåkrevd i forelder |
|
draft.brand_contextanyOf 1 / anyOf 2 | nullValgfritt / element | — |
draft.brand_reviewanyOf 1 | object | nullValgfritt / element | — |
draft.brand_reviewanyOf 1 / anyOf 1 | objectValgfritt / element | — |
draft.brand_review.rule_versionanyOf 1 / anyOf 1 | numberPåkrevd i forelder |
|
draft.brand_review.context_digestanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_review.content_digestanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_review.statusanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_review.issuesanyOf 1 / anyOf 1 | arrayPåkrevd i forelder |
|
draft.brand_review.issues[]anyOf 1 / anyOf 1 | objectValgfritt / element | — |
draft.brand_review.issues[].codeanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_review.issues[].targetanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 | integer | nullPåkrevd i forelder | — |
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 / anyOf 1 | integerPåkrevd i forelder |
|
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
draft.brand_review.issues[].messageanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
draft.brand_reviewanyOf 1 / anyOf 2 | nullValgfritt / element | — |
draftanyOf 2 | nullPåkrevd i forelder | — |
Fullstendig 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"
]
}Feil og trygge nye forsøk
Kontroller HTTP-status og svarinnhold. En 400-valideringsfeil kan inneholde en ZodError; håndteringsfeil bruker feltene error, message og code. Behold request_id eller x-request-id for feilsøking, uten påloggingsopplysninger. Rett 401/403-tilgangsfeil før nye forsøk, og følg Retry-After ved 429. Hvis en skriveoperasjon er usikker eller returnerer 5xx, les det eksisterende resultatet først. Gjenbruk bare en idempotensnøkkel der det støttes; virkemåten ved nye forsøk varierer mellom operasjoner og garanterer ikke levering nøyaktig én gang.
FeilsøkingsveiledningEksempler
Disse eksemplene bruker fiktive verdier kontrollert mot skjemaene. Erstatt ID-ene med noen du har lov til å bruke, mediene med klare ressurser og datoene med bekreftet publiseringstidspunkt. Kontroller kontoens kvalifikasjon før en skriveoperasjon sendes inn. Siden sender ingen API-forespørsler.
Angi SOSOAPI_ACCESS_TOKEN på serveren din til legitimasjon som operasjonen godtar, og hold den unna nettleserkode. For en KI-agent, bruk sosoapi auth login for innlogging gjennom nettleseren, og la CLI-et fornye legitimasjonen.
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.jsonSyntetisk svareksempel
{
"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
}