Prepare new ads or append to an existing campaign/ad set using request.ad_account_id, a saved template, and one creative_source. Choose append_mode and target IDs explicitly. Use copy_ad_quick_copy for live-ad copies. Review the draft; launch_confirm executes after approval Use the workflow's original link_id when exposed.
| Name | Required | Description | Default |
|---|---|---|---|
| request | Yes |
| Name | Required | Description | Default |
|---|---|---|---|
| message | No | ||
| retryable | No | ||
| support_ref | No |
Changes observed during successful MCP inspections.
Input schema / $defs / 0 / properties / country_groupsAdded value: +{
+ "items": {
+ "type": "string"
+ },
+ "maxItems": 300,
+ "type": "array"
+}Input schema / $defs / 0 / properties / excluded_country_groupsAdded value: +{
+ "items": {
+ "type": "string"
+ },
+ "maxItems": 300,
+ "type": "array"
+}Input schema / properties / request / properties / adset_naming / descriptionAdded value: +"Ad Set name pattern. {name} = rendered Campaign name; {index} = Ad Set number from 1 (continues after existing Ad Sets when appending). Use {index} so Ad Sets get distinct names."Input schema / properties / request / properties / campaign_naming / descriptionAdded value: +"Campaign name pattern. {index} = campaign number from 1; {name} = the literal \"Campaign\". Use {index} when campaign_count > 1."Input schema / properties / request / properties / creative_source / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "oneOf": [
- {
- "anyOf": [
- {
- "properties": {
- "creative_names": {
- "minItems": 1,
- "type": "array"
- }
- },
- "required": [
- "creative_names"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "maxItems": 0
- },
- "existing_posts": {
- "maxItems": 0
- },
- "mode": {
- "const": "creative"
- },
- "partnership_rows": {
- "maxItems": 0
- }
- }
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "maxItems": 0
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "maxItems": 0
- },
- "mode": {
- "const": "partnership"
- },
- "partnership_rows": {
- "minItems": 1,
- "type": "array"
- }
- },
- "required": [
- "mode",
- "partnership_rows"
- ]
- },
- {
- "properties": {
- "carousel_groups": {
- "maxItems": 0
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "maxItems": 0
- },
- "media_mode": {
- "const": "single"
- },
- "mode": {
- "const": "template_source"
- },
- "partnership_rows": {
- "maxItems": 0
- }
- },
- "required": [
- "mode"
- ]
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "minItems": 1,
- "type": "array"
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "maxItems": 0
- },
- "mode": {
- "const": "carousel"
- },
- "partnership_rows": {
- "maxItems": 0
- }
- },
- "required": [
- "mode",
- "carousel_groups"
- ]
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "maxItems": 0
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "minItems": 1,
- "type": "array"
- },
- "media_mode": {
- "const": "single"
- },
- "mode": {
- "const": "existing_post"
- },
- "partnership_rows": {
- "maxItems": 0
- }
- },
- "required": [
- "mode",
- "existing_posts"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "carousel_groups": {
- "items": {
- "additionalProperties": false,
- "allOf": [
- {
- "required": [
- "ad_name"
- ]
- },
- {
- "properties": {
- "creative_names": {
- "minItems": 2,
- "not": {
- "type": "null"
- }
- }
- },
- "required": [
- "creative_names"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "body": {
- "maxLength": 5000,
- "type": "string"
- },
- "card_overrides": {
- "description": "Optional per-card title, description, link_url, cta and display_link, each matched to a card by creative_id/creative_name. A field left out falls back to this group's title/description and the template's link and CTA.",
- "items": {
- "additionalProperties": false,
- "description": "Copy for one carousel card; every field left out uses the group's value.",
- "oneOf": [
- {
- "properties": {
- "creative_name": {
- "type": "string"
- }
- },
- "required": [
- "creative_name"
- ]
- }
- ],
- "properties": {
- "creative_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "cta": {
- "description": "Call-to-action button. Common values: LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD, INSTALL_MOBILE_APP, GET_OFFER, SUBSCRIBE, BOOK_NOW, APPLY_NOW, CONTACT_US, SEE_DETAILS. Free text is accepted and normalised (\"Learn More\" -> LEARN_MORE); Meta has more types than are listed here. Phone, message and profile CTAs do not fit a website or app destination. Omit to keep the template's CTA.",
- "maxLength": 100,
- "type": "string"
- },
- "description": {
- "maxLength": 500,
- "type": "string"
- },
- "display_link": {
- "description": "Display URL shown under the card (caption).",
- "maxLength": 255,
- "type": "string"
- },
- "link_url": {
- "description": "Card landing URL.",
- "maxLength": 2048,
- "type": "string"
- },
- "title": {
- "description": "Card headline.",
- "maxLength": 500,
- "type": "string"
- }
- },
- "type": "object"
- },
- "maxItems": 10,
- "type": "array"
- },
- "creative_names": {
- "items": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "maxItems": 10,
- "type": "array"
- },
- "description": {
- "maxLength": 500,
- "type": "string"
- },
- "title": {
- "maxLength": 500,
- "type": "string"
- }
- },
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "creative_names": {
- "items": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "maxItems": 50,
- "type": "array"
- },
- "creative_overrides": {
- "items": {
- "additionalProperties": false,
- "oneOf": [
- {
- "properties": {
- "creative_name": {
- "type": "string"
- }
- },
- "required": [
- "creative_name"
- ]
- }
- ],
- "properties": {
- "body": {
- "maxLength": 5000,
- "type": "string"
- },
- "creative_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "deeplink": {
- "maxLength": 2048,
- "type": "string"
- },
- "description": {
- "maxLength": 500,
- "type": "string"
- },
- "title": {
- "maxLength": 500,
- "type": "string"
- }
- },
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "existing_posts": {
- "items": {
- "additionalProperties": false,
- "allOf": [
- {
- "required": [
- "ad_name"
- ]
- },
- {
- "oneOf": [
- {
- "properties": {
- "instagram_media_id": {
- "type": "string"
- },
- "page_post_id": {
- "type": "null"
- }
- },
- "required": [
- "instagram_media_id"
- ]
- },
- {
- "properties": {
- "instagram_media_id": {
- "type": "null"
- },
- "page_post_id": {
- "type": "string"
- }
- },
- "required": [
- "page_post_id"
- ]
- }
- ]
- }
- ],
- "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "instagram_media_id": {
- "pattern": "^[0-9]{1,32}$",
- "type": "string"
- },
- "page_post_id": {
- "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
- "type": "string"
- }
- },
- "required": [
- "ad_name"
- ],
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "media_mode": {
- "enum": [
- "single",
- "multi"
- ],
- "type": "string"
- },
- "mode": {
- "default": "creative",
- "enum": [
- "creative",
- "partnership",
- "template_source",
- "carousel",
- "existing_post"
- ],
- "type": "string"
- },
- "partnership_rows": {
- "items": {
- "additionalProperties": false,
- "anyOf": [
- {
- "required": [
- "partnership_ad_id"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "deeplink": {
- "maxLength": 2048,
- "type": "string"
- },
- "original_post_url": {
- "maxLength": 2048,
- "type": "string"
- },
- "partnership_ad_id": {
- "description": "Meta partnership ad ID.",
- "maxLength": 4096,
- "minLength": 1,
- "type": "string"
- },
- "source_choice": {
- "default": "auto",
- "enum": [
- "auto",
- "new"
- ],
- "type": "string"
- },
- "source_ref": {
- "pattern": "^(ad|creative):[0-9]{1,32}$",
- "type": "string"
- }
- },
- "required": [
- "ad_name"
- ],
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- }
- },
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "media_mode": {
- "const": "single",
- "default": "single",
- "type": "string"
- },
- "media_refs": {
- "items": {
- "maxLength": 2048,
- "minLength": 16,
- "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
- "type": "string"
- },
- "maxItems": 50,
- "minItems": 1,
- "type": "array"
- },
- "mode": {
- "const": "account_media",
- "type": "string"
- }
- },
- "required": [
- "mode",
- "media_refs"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "oneOf": [
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "creative_names": {
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "required": [
+ "creative_names"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "mode": {
+ "const": "creative"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ }
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "mode": {
+ "const": "partnership"
+ },
+ "partnership_rows": {
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "required": [
+ "mode",
+ "partnership_rows"
+ ]
+ },
+ {
+ "properties": {
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "media_mode": {
+ "const": "single"
+ },
+ "mode": {
+ "const": "template_source"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ },
+ "required": [
+ "mode"
+ ]
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "minItems": 1,
+ "type": "array"
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "mode": {
+ "const": "carousel"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ },
+ "required": [
+ "mode",
+ "carousel_groups"
+ ]
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "minItems": 1,
+ "type": "array"
+ },
+ "media_mode": {
+ "const": "single"
+ },
+ "mode": {
+ "const": "existing_post"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ },
+ "required": [
+ "mode",
+ "existing_posts"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "carousel_groups": {
+ "items": {
+ "additionalProperties": false,
+ "allOf": [
+ {
+ "required": [
+ "ad_name"
+ ]
+ },
+ {
+ "properties": {
+ "creative_names": {
+ "minItems": 2,
+ "not": {
+ "type": "null"
+ }
+ }
+ },
+ "required": [
+ "creative_names"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "body": {
+ "maxLength": 5000,
+ "type": "string"
+ },
+ "card_overrides": {
+ "description": "Optional per-card title, description, link_url, cta and display_link, each matched to a card by creative_id/creative_name. A field left out falls back to this group's title/description and the template's link and CTA.",
+ "items": {
+ "additionalProperties": false,
+ "description": "Copy for one carousel card; every field left out uses the group's value.",
+ "oneOf": [
+ {
+ "properties": {
+ "creative_name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "creative_name"
+ ]
+ }
+ ],
+ "properties": {
+ "creative_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "cta": {
+ "description": "Call-to-action button. Common values: LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD, INSTALL_MOBILE_APP, GET_OFFER, SUBSCRIBE, BOOK_NOW, APPLY_NOW, CONTACT_US, SEE_DETAILS. Free text is accepted and normalised (\"Learn More\" -> LEARN_MORE); Meta has more types than are listed here. Phone, message and profile CTAs do not fit a website or app destination. Omit to keep the template's CTA.",
+ "maxLength": 100,
+ "type": "string"
+ },
+ "description": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "display_link": {
+ "description": "Display URL shown under the card (caption).",
+ "maxLength": 255,
+ "type": "string"
+ },
+ "link_url": {
+ "description": "Card landing URL.",
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "title": {
+ "description": "Card headline.",
+ "maxLength": 500,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "creative_names": {
+ "items": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "description": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 500,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "creative_names": {
+ "items": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "creative_overrides": {
+ "description": "Per-creative copy: one entry per creative_name with optional title/body/description; omitted fields inherit overrides.*. With one_per_adset each Ad Set gets its own copy. No new template needed.",
+ "items": {
+ "additionalProperties": false,
+ "oneOf": [
+ {
+ "properties": {
+ "creative_name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "creative_name"
+ ]
+ }
+ ],
+ "properties": {
+ "body": {
+ "maxLength": 5000,
+ "type": "string"
+ },
+ "creative_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "deeplink": {
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "description": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 500,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "existing_posts": {
+ "items": {
+ "additionalProperties": false,
+ "allOf": [
+ {
+ "required": [
+ "ad_name"
+ ]
+ },
+ {
+ "oneOf": [
+ {
+ "properties": {
+ "instagram_media_id": {
+ "type": "string"
+ },
+ "page_post_id": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "instagram_media_id"
+ ]
+ },
+ {
+ "properties": {
+ "instagram_media_id": {
+ "type": "null"
+ },
+ "page_post_id": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "page_post_id"
+ ]
+ }
+ ]
+ }
+ ],
+ "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "instagram_media_id": {
+ "pattern": "^[0-9]{1,32}$",
+ "type": "string"
+ },
+ "page_post_id": {
+ "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ad_name"
+ ],
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "media_mode": {
+ "enum": [
+ "single",
+ "multi"
+ ],
+ "type": "string"
+ },
+ "mode": {
+ "default": "creative",
+ "enum": [
+ "creative",
+ "partnership",
+ "template_source",
+ "carousel",
+ "existing_post"
+ ],
+ "type": "string"
+ },
+ "partnership_rows": {
+ "items": {
+ "additionalProperties": false,
+ "anyOf": [
+ {
+ "required": [
+ "partnership_ad_id"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "deeplink": {
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "original_post_url": {
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "partnership_ad_id": {
+ "description": "Meta partnership ad ID.",
+ "maxLength": 4096,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source_choice": {
+ "default": "auto",
+ "enum": [
+ "auto",
+ "new"
+ ],
+ "type": "string"
+ },
+ "source_ref": {
+ "pattern": "^(ad|creative):[0-9]{1,32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ad_name"
+ ],
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "media_mode": {
+ "const": "single",
+ "default": "single",
+ "type": "string"
+ },
+ "media_refs": {
+ "items": {
+ "maxLength": 2048,
+ "minLength": 16,
+ "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
+ "type": "string"
+ },
+ "maxItems": 50,
+ "minItems": 1,
+ "type": "array"
+ },
+ "mode": {
+ "const": "account_media",
+ "type": "string"
+ }
+ },
+ "required": [
+ "mode",
+ "media_refs"
+ ],
+ "type": "object"
+ }
+]Input schema / properties / request / properties / overrides / properties / body / descriptionAdded value: +"Shared by every ad; for per-creative copy use creative_source.creative_overrides[]."Input schema / properties / request / properties / overrides / properties / description / descriptionAdded value: +"Shared by every ad; for per-creative copy use creative_source.creative_overrides[]."Input schema / properties / request / properties / overrides / properties / title / descriptionAdded value: +"Shared by every ad; for per-creative copy use creative_source.creative_overrides[]."Input schema / properties / connection_contextRemoved value: -{
- "pattern": "^mctx_v1_[0-9a-f]{64}$",
- "type": "string"
-}Output schema / $defsRemoved value: -{
- "s0": {
- "properties": {
- "amount": {
- "type": [
- "number",
- "null"
- ]
- },
- "currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "level": {
- "type": "string"
- },
- "mode": {
- "type": "string"
- },
- "total_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "unit": {
- "type": "string"
- }
- },
- "type": [
- "null",
- "object"
- ]
- },
- "s1": {
- "properties": {
- "amount": {
- "type": [
- "number",
- "null"
- ]
- },
- "currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "level": {
- "type": "string"
- },
- "mode": {
- "type": "string"
- },
- "total_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "unit": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "s2": {
- "items": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "anyOf": [
- {
- "properties": {
- "code": {
- "type": "string"
- }
- },
- "required": [
- "code"
- ]
- },
- {
- "required": [
- "message"
- ]
- }
- ],
- "properties": {
- "message": {
- "type": "string"
- }
- },
- "type": "object"
- }
- ]
- },
- "type": "array"
- }
-}Output schema / else / else / anyOfPrevious value: -[
- {
- "properties": {
- "approval_request": {
- "properties": {
- "approval_ref": {
- "type": "string"
- },
- "confirm_token": {
- "type": "string"
- },
- "confirm_tool": {
- "type": "string"
- },
- "expires_at": {
- "type": "string"
- },
- "instruction_template_id": {
- "type": "string"
- },
- "mode": {
- "type": "string"
- },
- "plan_digest": {
- "type": "string"
- },
- "schema_version": {
- "type": "integer"
- },
- "status": {
- "const": "approval_required"
- },
- "summary": {
- "properties": {
- "account_currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "action": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_count": {
- "type": "integer"
- },
- "ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_count": {
- "type": "integer"
- },
- "adset_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "bid": {
- "$ref": "#/$defs/s0"
- },
- "budget": {
- "$ref": "#/$defs/s0"
- },
- "campaign_count": {
- "type": "integer"
- },
- "campaign_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "change_percent": {
- "type": [
- "number",
- "null"
- ]
- },
- "copies": {
- "type": "integer"
- },
- "count": {
- "type": "integer"
- },
- "creative_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "creative_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "cross_account": {
- "type": "boolean"
- },
- "current_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "engagement_mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_type": {
- "type": [
- "string",
- "null"
- ]
- },
- "groups": {
- "items": {
- "properties": {
- "adsets": {
- "items": {
- "properties": {
- "name": {
- "type": [
- "string",
- "null"
- ]
- },
- "target_adset_id": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "bid": {
- "$ref": "#/$defs/s1"
- },
- "budget": {
- "$ref": "#/$defs/s1"
- },
- "campaign_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "layout": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "items": {
- "items": {
- "properties": {
- "ad_account_id": {
- "type": "string"
- },
- "ad_id": {
- "type": "string"
- },
- "campaign_id": {
- "type": "string"
- },
- "current_configured_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "current_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "target_configured_status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "note": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "preflight": {
- "properties": {
- "ad_account_id": {
- "type": "string"
- },
- "billing": {
- "properties": {
- "available_funds_major": {
- "type": [
- "number",
- "null"
- ]
- },
- "balance_semantics": {
- "type": "string"
- },
- "currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "low_remaining_spend_cap": {
- "type": "boolean"
- },
- "note": {
- "type": "string"
- },
- "reported_balance_major": {
- "type": [
- "number",
- "null"
- ]
- },
- "spend_cap_remaining_major": {
- "type": [
- "number",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "checked_at": {
- "type": "string"
- },
- "checks": {
- "items": {
- "properties": {
- "asset_id": {
- "type": "string"
- },
- "asset_type": {
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "provider_error_code": {
- "type": "integer"
- },
- "provider_error_subcode": {
- "type": "integer"
- },
- "reason_code": {
- "type": "string"
- },
- "status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "status": {
- "type": "string"
- },
- "timing": {
- "properties": {
- "account_local_now": {
- "type": [
- "string",
- "null"
- ]
- },
- "hours_left_today": {
- "type": [
- "number",
- "null"
- ]
- },
- "note": {
- "type": "string"
- },
- "schedule_valid": {
- "type": "boolean"
- },
- "timezone_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "utc_offset_hours": {
- "type": "number"
- },
- "windows": {
- "items": {
- "properties": {
- "end_time": {
- "type": [
- "string",
- "null"
- ]
- },
- "hours_remaining": {
- "type": [
- "number",
- "null"
- ]
- },
- "hours_until_start": {
- "type": "number"
- },
- "paused": {
- "type": "boolean"
- },
- "potential_delivery_hours_today": {
- "type": "number"
- },
- "start_time": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "version": {
- "type": "integer"
- },
- "warnings": {
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "required": [
- "version",
- "checked_at",
- "ad_account_id",
- "status",
- "checks",
- "warnings"
- ],
- "type": "object"
- },
- "publish_start_label": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_level": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "statuses": {
- "properties": {
- "ad": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "structure": {
- "properties": {
- "ads": {
- "type": "integer"
- },
- "adsets": {
- "type": "integer"
- },
- "auxiliary_writes": {
- "type": "integer"
- },
- "campaigns": {
- "type": "integer"
- },
- "creative_keys": {
- "type": "integer"
- },
- "layouts": {
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "target_ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "template_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "type": "object"
- },
- "tool_name": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "required": [
- "status",
- "confirm_token",
- "expires_at",
- "summary"
- ],
- "type": "object"
- },
- "status": {
- "type": "string"
- }
- },
- "required": [
- "approval_request"
- ]
- },
- {
- "properties": {
- "missing_requirements": {
- "items": {
- "properties": {
- "field": {
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "override_path": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "safe_to_retry_with_user_input": {
- "const": true
- },
- "status": {
- "const": "needs_input"
- },
- "user_instruction": {
- "type": "string"
- }
- },
- "required": [
- "status",
- "user_instruction",
- "safe_to_retry_with_user_input"
- ]
- },
- {
- "properties": {
- "account_blocker_code": {
- "type": [
- "string",
- "null"
- ]
- },
- "account_blocker_label": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "automatic_retry_allowed": {
- "type": "boolean"
- },
- "category": {
- "type": [
- "string",
- "null"
- ]
- },
- "code": {
- "type": [
- "string",
- "null"
- ]
- },
- "invalid_fields": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "manual_new_task_allowed": {
- "type": "boolean"
- },
- "narrative": {
- "properties": {
- "details": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "headline": {
- "type": "string"
- },
- "summary": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "what_happens_next": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "operator_review_required": {
- "type": "boolean"
- },
- "status": {
- "const": "blocked"
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "required": [
- "status",
- "narrative"
- ]
- }
-]New value: +[
+ {
+ "required": [
+ "approval_request"
+ ]
+ },
+ {
+ "properties": {
+ "safe_to_retry_with_user_input": {
+ "const": true
+ },
+ "status": {
+ "const": "needs_input"
+ }
+ },
+ "required": [
+ "safe_to_retry_with_user_input",
+ "status",
+ "user_instruction"
+ ]
+ },
+ {
+ "properties": {
+ "status": {
+ "const": "blocked"
+ }
+ },
+ "required": [
+ "narrative",
+ "status"
+ ]
+ }
+]Output schema / else / else / propertiesAdded value: +{
+ "account_blocker_code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "account_blocker_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "approval_request": {
+ "properties": {
+ "approval_ref": {
+ "type": "string"
+ },
+ "confirm_token": {
+ "type": "string"
+ },
+ "confirm_tool": {
+ "type": "string"
+ },
+ "expires_at": {
+ "type": "string"
+ },
+ "instruction_template_id": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "plan_digest": {
+ "type": "string"
+ },
+ "schema_version": {
+ "type": "integer"
+ },
+ "status": {
+ "const": "approval_required"
+ },
+ "summary": {
+ "properties": {
+ "account_currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "action": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_count": {
+ "type": "integer"
+ },
+ "ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_count": {
+ "type": "integer"
+ },
+ "adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "bid": {
+ "properties": {
+ "amount": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "level": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "total_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "unit": {
+ "type": "string"
+ }
+ },
+ "type": [
+ "null",
+ "object"
+ ]
+ },
+ "budget": {
+ "properties": {
+ "amount": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "level": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "total_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "unit": {
+ "type": "string"
+ }
+ },
+ "type": [
+ "null",
+ "object"
+ ]
+ },
+ "campaign_count": {
+ "type": "integer"
+ },
+ "campaign_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "change_percent": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "copies": {
+ "type": "integer"
+ },
+ "count": {
+ "type": "integer"
+ },
+ "creative_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "creative_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "cross_account": {
+ "type": "boolean"
+ },
+ "current_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "engagement_mode": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_type": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "groups": {
+ "items": {
+ "properties": {
+ "adsets": {
+ "items": {
+ "properties": {
+ "name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "target_adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "bid": {
+ "properties": {
+ "amount": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "level": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "total_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "unit": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "budget": {
+ "properties": {
+ "amount": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "level": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "total_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "unit": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "campaign_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "layout": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "items": {
+ "items": {
+ "properties": {
+ "ad_account_id": {
+ "type": "string"
+ },
+ "ad_id": {
+ "type": "string"
+ },
+ "campaign_id": {
+ "type": "string"
+ },
+ "current_configured_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "current_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "new_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "target_configured_status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "mode": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "new_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "note": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page_id_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page_id_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preflight": {
+ "properties": {
+ "ad_account_id": {
+ "type": "string"
+ },
+ "billing": {
+ "properties": {
+ "available_funds_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "balance_semantics": {
+ "type": "string"
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "low_remaining_spend_cap": {
+ "type": "boolean"
+ },
+ "note": {
+ "type": "string"
+ },
+ "reported_balance_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend_cap_remaining_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "checked_at": {
+ "type": "string"
+ },
+ "checks": {
+ "items": {
+ "properties": {
+ "asset_id": {
+ "type": "string"
+ },
+ "asset_type": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "provider_error_code": {
+ "type": "integer"
+ },
+ "provider_error_subcode": {
+ "type": "integer"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "status": {
+ "type": "string"
+ },
+ "timing": {
+ "properties": {
+ "account_local_now": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hours_left_today": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "note": {
+ "type": "string"
+ },
+ "schedule_valid": {
+ "type": "boolean"
+ },
+ "timezone_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "utc_offset_hours": {
+ "type": "number"
+ },
+ "windows": {
+ "items": {
+ "properties": {
+ "end_time": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hours_remaining": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "hours_until_start": {
+ "type": "number"
+ },
+ "paused": {
+ "type": "boolean"
+ },
+ "potential_delivery_hours_today": {
+ "type": "number"
+ },
+ "start_time": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "version": {
+ "type": "integer"
+ },
+ "warnings": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "version",
+ "checked_at",
+ "ad_account_id",
+ "status",
+ "checks",
+ "warnings"
+ ],
+ "type": "object"
+ },
+ "publish_start_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_level": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "statuses": {
+ "properties": {
+ "ad": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "structure": {
+ "properties": {
+ "ads": {
+ "type": "integer"
+ },
+ "adsets": {
+ "type": "integer"
+ },
+ "auxiliary_writes": {
+ "type": "integer"
+ },
+ "campaigns": {
+ "type": "integer"
+ },
+ "creative_keys": {
+ "type": "integer"
+ },
+ "layouts": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "target_ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "template_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "warnings": {
+ "items": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "code": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "code"
+ ]
+ },
+ {
+ "required": [
+ "message"
+ ]
+ }
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "tool_name": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "warnings": {
+ "items": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "code": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "code"
+ ]
+ },
+ {
+ "required": [
+ "message"
+ ]
+ }
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "status",
+ "confirm_token",
+ "expires_at",
+ "summary"
+ ],
+ "type": "object"
+ },
+ "automatic_retry_allowed": {
+ "type": "boolean"
+ },
+ "category": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "invalid_fields": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "manual_new_task_allowed": {
+ "type": "boolean"
+ },
+ "missing_requirements": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "override_path": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "narrative": {
+ "properties": {
+ "details": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "headline": {
+ "type": "string"
+ },
+ "summary": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "what_happens_next": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "operator_review_required": {
+ "type": "boolean"
+ },
+ "safe_to_retry_with_user_input": {
+ "const": true
+ },
+ "status": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "warnings": {
+ "items": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "code": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "code"
+ ]
+ },
+ {
+ "required": [
+ "message"
+ ]
+ }
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ }
+}Input schema / $defsAdded value: +{
+ "0": {
+ "additionalProperties": false,
+ "properties": {
+ "age": {
+ "additionalProperties": false,
+ "properties": {
+ "max": {
+ "maximum": 65,
+ "minimum": 13,
+ "type": "integer"
+ },
+ "min": {
+ "maximum": 65,
+ "minimum": 13,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "min"
+ ],
+ "type": "object"
+ },
+ "cities": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "country": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "name": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "region": {
+ "maxLength": 200,
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "country"
+ ],
+ "type": "object"
+ },
+ "maxItems": 100,
+ "type": "array"
+ },
+ "countries": {
+ "items": {
+ "type": "string"
+ },
+ "maxItems": 300,
+ "type": "array"
+ },
+ "excluded_countries": {
+ "items": {
+ "type": "string"
+ },
+ "maxItems": 300,
+ "type": "array"
+ },
+ "gender": {
+ "default": "all",
+ "enum": [
+ "all",
+ "female",
+ "male"
+ ],
+ "type": "string"
+ },
+ "languages": {
+ "items": {
+ "type": "string"
+ },
+ "maxItems": 100,
+ "type": "array"
+ },
+ "languages_mode": {
+ "enum": [
+ "restricted",
+ "all"
+ ],
+ "type": "string"
+ },
+ "placements": {
+ "anyOf": [
+ {
+ "const": "automatic",
+ "type": "string"
+ },
+ {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ ],
+ "default": "automatic"
+ },
+ "regions": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "country": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "name": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "country"
+ ],
+ "type": "object"
+ },
+ "maxItems": 100,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ }
+}Input schema / properties / request / allOfPrevious value: -[
- {
- "required": [
- "template_name"
- ]
- },
- {
- "properties": {
- "creative_source": {
- "type": "object"
- }
- },
- "required": [
- "creative_source"
- ]
- }
-]New value: +[
+ {
+ "required": [
+ "template_name"
+ ]
+ },
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "creative_source": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "creative_source"
+ ]
+ },
+ {
+ "properties": {
+ "groups": {
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "required": [
+ "groups"
+ ]
+ }
+ ]
+ }
+]Input schema / properties / request / properties / activationAdded value: +{
+ "additionalProperties": false,
+ "properties": {
+ "on_partial": {
+ "default": "activate_complete",
+ "enum": [
+ "activate_complete",
+ "keep_paused",
+ "rollback_all"
+ ],
+ "type": "string"
+ },
+ "requested": {
+ "default": "paused",
+ "enum": [
+ "active",
+ "paused"
+ ],
+ "type": "string"
+ }
+ },
+ "type": "object"
+}Input schema / properties / request / properties / execution / properties / statuses / properties / ad / anyOfAdded value: +[
+ {
+ "description": "Use 开启 or 暂停.",
+ "enum": [
+ "开启",
+ "启用",
+ "暂停",
+ "active",
+ "paused"
+ ],
+ "type": "string"
+ },
+ {
+ "deprecated": true,
+ "description": "Deprecated platform values; use 开启 or 暂停.",
+ "enum": [
+ "ACTIVE",
+ "PAUSED"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+]Input schema / properties / request / properties / execution / properties / statuses / properties / ad / defaultAdded value: +nullInput schema / properties / request / properties / execution / properties / statuses / properties / ad / enumRemoved value: -[
- "ACTIVE",
- "PAUSED"
-]Input schema / properties / request / properties / execution / properties / statuses / properties / ad / typeRemoved value: -"string"Input schema / properties / request / properties / execution / properties / statuses / properties / adset / anyOfAdded value: +[
+ {
+ "description": "Use 开启 or 暂停.",
+ "enum": [
+ "开启",
+ "启用",
+ "暂停",
+ "active",
+ "paused"
+ ],
+ "type": "string"
+ },
+ {
+ "deprecated": true,
+ "description": "Deprecated platform values; use 开启 or 暂停.",
+ "enum": [
+ "ACTIVE",
+ "PAUSED"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+]Input schema / properties / request / properties / execution / properties / statuses / properties / adset / defaultAdded value: +nullInput schema / properties / request / properties / execution / properties / statuses / properties / adset / enumRemoved value: -[
- "ACTIVE",
- "PAUSED"
-]Input schema / properties / request / properties / execution / properties / statuses / properties / adset / typeRemoved value: -"string"Input schema / properties / request / properties / execution / properties / statuses / properties / campaign / anyOfAdded value: +[
+ {
+ "description": "Use 开启 or 暂停.",
+ "enum": [
+ "开启",
+ "启用",
+ "暂停",
+ "active",
+ "paused"
+ ],
+ "type": "string"
+ },
+ {
+ "deprecated": true,
+ "description": "Deprecated platform values; use 开启 or 暂停.",
+ "enum": [
+ "ACTIVE",
+ "PAUSED"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+]Input schema / properties / request / properties / execution / properties / statuses / properties / campaign / defaultAdded value: +nullInput schema / properties / request / properties / execution / properties / statuses / properties / campaign / enumRemoved value: -[
- "ACTIVE",
- "PAUSED"
-]Input schema / properties / request / properties / execution / properties / statuses / properties / campaign / typeRemoved value: -"string"Input schema / properties / request / properties / groupsAdded value: +{
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "budget": {
+ "exclusiveMinimum": 0,
+ "type": "number"
+ },
+ "creatives": {
+ "items": {
+ "maxLength": 2048,
+ "minLength": 1,
+ "type": "string"
+ },
+ "maxItems": 50,
+ "minItems": 1,
+ "type": "array"
+ },
+ "key": {
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "name": {
+ "maxLength": 300,
+ "minLength": 1,
+ "type": "string"
+ },
+ "targeting": {
+ "$ref": "#/$defs/0"
+ }
+ },
+ "required": [
+ "key",
+ "creatives"
+ ],
+ "type": "object"
+ },
+ "maxItems": 20,
+ "minItems": 1,
+ "type": "array"
+}Input schema / properties / request / properties / overrides / properties / countries_override / deprecatedAdded value: +trueInput schema / properties / request / properties / overrides / properties / countries_override / descriptionAdded value: +"Deprecated: use targeting.countries with country names."Input schema / properties / request / properties / overrides / properties / countries_override / items / maxLengthPrevious value: -8New value: +200Input schema / properties / request / properties / overrides / properties / locales_override / deprecatedAdded value: +trueInput schema / properties / request / properties / overrides / properties / locales_override / descriptionAdded value: +"Deprecated: use targeting.languages with language names."Input schema / properties / request / properties / targetingAdded value: +{
+ "$ref": "#/$defs/0",
+ "description": "Use language and country names, for example {\"languages\": [\"英语\"], \"countries\": [\"美国\"]}."
+}Output schema / else / else / anyOfPrevious value: -[
- {
- "properties": {
- "approval_request": {
- "properties": {
- "approval_ref": {
- "type": "string"
- },
- "confirm_token": {
- "type": "string"
- },
- "expires_at": {
- "type": "string"
- },
- "mode": {
- "type": "string"
- },
- "plan_digest": {
- "type": "string"
- },
- "schema_version": {
- "type": "integer"
- },
- "status": {
- "const": "approval_required"
- },
- "summary": {
- "properties": {
- "account_currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "action": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_count": {
- "type": "integer"
- },
- "ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_count": {
- "type": "integer"
- },
- "adset_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "bid": {
- "$ref": "#/$defs/s0"
- },
- "budget": {
- "$ref": "#/$defs/s0"
- },
- "campaign_count": {
- "type": "integer"
- },
- "campaign_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "change_percent": {
- "type": [
- "number",
- "null"
- ]
- },
- "copies": {
- "type": "integer"
- },
- "count": {
- "type": "integer"
- },
- "creative_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "creative_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "cross_account": {
- "type": "boolean"
- },
- "current_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "engagement_mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_type": {
- "type": [
- "string",
- "null"
- ]
- },
- "groups": {
- "items": {
- "properties": {
- "adsets": {
- "items": {
- "properties": {
- "name": {
- "type": [
- "string",
- "null"
- ]
- },
- "target_adset_id": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "bid": {
- "$ref": "#/$defs/s1"
- },
- "budget": {
- "$ref": "#/$defs/s1"
- },
- "campaign_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "layout": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "items": {
- "items": {
- "properties": {
- "ad_account_id": {
- "type": "string"
- },
- "ad_id": {
- "type": "string"
- },
- "campaign_id": {
- "type": "string"
- },
- "current_configured_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "current_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "target_configured_status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "note": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "preflight": {
- "properties": {
- "ad_account_id": {
- "type": "string"
- },
- "billing": {
- "properties": {
- "available_funds_major": {
- "type": [
- "number",
- "null"
- ]
- },
- "balance_semantics": {
- "type": "string"
- },
- "currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "low_remaining_spend_cap": {
- "type": "boolean"
- },
- "note": {
- "type": "string"
- },
- "reported_balance_major": {
- "type": [
- "number",
- "null"
- ]
- },
- "spend_cap_remaining_major": {
- "type": [
- "number",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "checked_at": {
- "type": "string"
- },
- "checks": {
- "items": {
- "properties": {
- "asset_id": {
- "type": "string"
- },
- "asset_type": {
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "provider_error_code": {
- "type": "integer"
- },
- "provider_error_subcode": {
- "type": "integer"
- },
- "reason_code": {
- "type": "string"
- },
- "status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "status": {
- "type": "string"
- },
- "timing": {
- "properties": {
- "account_local_now": {
- "type": [
- "string",
- "null"
- ]
- },
- "hours_left_today": {
- "type": [
- "number",
- "null"
- ]
- },
- "note": {
- "type": "string"
- },
- "schedule_valid": {
- "type": "boolean"
- },
- "timezone_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "utc_offset_hours": {
- "type": "number"
- },
- "windows": {
- "items": {
- "properties": {
- "end_time": {
- "type": [
- "string",
- "null"
- ]
- },
- "hours_remaining": {
- "type": [
- "number",
- "null"
- ]
- },
- "hours_until_start": {
- "type": "number"
- },
- "paused": {
- "type": "boolean"
- },
- "potential_delivery_hours_today": {
- "type": "number"
- },
- "start_time": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "version": {
- "type": "integer"
- },
- "warnings": {
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "required": [
- "version",
- "checked_at",
- "ad_account_id",
- "status",
- "checks",
- "warnings"
- ],
- "type": "object"
- },
- "publish_start_label": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_level": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "statuses": {
- "properties": {
- "ad": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "structure": {
- "properties": {
- "ads": {
- "type": "integer"
- },
- "adsets": {
- "type": "integer"
- },
- "auxiliary_writes": {
- "type": "integer"
- },
- "campaigns": {
- "type": "integer"
- },
- "creative_keys": {
- "type": "integer"
- },
- "layouts": {
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "target_ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "template_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "type": "object"
- },
- "tool_name": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "required": [
- "status",
- "confirm_token",
- "expires_at",
- "summary"
- ],
- "type": "object"
- },
- "status": {
- "type": "string"
- }
- },
- "required": [
- "approval_request"
- ]
- },
- {
- "properties": {
- "missing_requirements": {
- "items": {
- "properties": {
- "field": {
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "override_path": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "safe_to_retry_with_user_input": {
- "const": true
- },
- "status": {
- "const": "needs_input"
- },
- "user_instruction": {
- "type": "string"
- }
- },
- "required": [
- "status",
- "user_instruction",
- "safe_to_retry_with_user_input"
- ]
- },
- {
- "properties": {
- "account_blocker_code": {
- "type": [
- "string",
- "null"
- ]
- },
- "account_blocker_label": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "automatic_retry_allowed": {
- "type": "boolean"
- },
- "category": {
- "type": [
- "string",
- "null"
- ]
- },
- "code": {
- "type": [
- "string",
- "null"
- ]
- },
- "invalid_fields": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "manual_new_task_allowed": {
- "type": "boolean"
- },
- "narrative": {
- "properties": {
- "details": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "headline": {
- "type": "string"
- },
- "summary": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "what_happens_next": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "operator_review_required": {
- "type": "boolean"
- },
- "status": {
- "const": "blocked"
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "required": [
- "status",
- "narrative"
- ]
- }
-]New value: +[
+ {
+ "properties": {
+ "approval_request": {
+ "properties": {
+ "approval_ref": {
+ "type": "string"
+ },
+ "confirm_token": {
+ "type": "string"
+ },
+ "confirm_tool": {
+ "type": "string"
+ },
+ "expires_at": {
+ "type": "string"
+ },
+ "instruction_template_id": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "plan_digest": {
+ "type": "string"
+ },
+ "schema_version": {
+ "type": "integer"
+ },
+ "status": {
+ "const": "approval_required"
+ },
+ "summary": {
+ "properties": {
+ "account_currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "action": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_count": {
+ "type": "integer"
+ },
+ "ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_count": {
+ "type": "integer"
+ },
+ "adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "bid": {
+ "$ref": "#/$defs/s0"
+ },
+ "budget": {
+ "$ref": "#/$defs/s0"
+ },
+ "campaign_count": {
+ "type": "integer"
+ },
+ "campaign_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "change_percent": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "copies": {
+ "type": "integer"
+ },
+ "count": {
+ "type": "integer"
+ },
+ "creative_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "creative_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "cross_account": {
+ "type": "boolean"
+ },
+ "current_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "engagement_mode": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_type": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "groups": {
+ "items": {
+ "properties": {
+ "adsets": {
+ "items": {
+ "properties": {
+ "name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "target_adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "bid": {
+ "$ref": "#/$defs/s1"
+ },
+ "budget": {
+ "$ref": "#/$defs/s1"
+ },
+ "campaign_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "layout": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "items": {
+ "items": {
+ "properties": {
+ "ad_account_id": {
+ "type": "string"
+ },
+ "ad_id": {
+ "type": "string"
+ },
+ "campaign_id": {
+ "type": "string"
+ },
+ "current_configured_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "current_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "new_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "target_configured_status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "mode": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "new_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "note": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page_id_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page_id_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preflight": {
+ "properties": {
+ "ad_account_id": {
+ "type": "string"
+ },
+ "billing": {
+ "properties": {
+ "available_funds_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "balance_semantics": {
+ "type": "string"
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "low_remaining_spend_cap": {
+ "type": "boolean"
+ },
+ "note": {
+ "type": "string"
+ },
+ "reported_balance_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend_cap_remaining_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "checked_at": {
+ "type": "string"
+ },
+ "checks": {
+ "items": {
+ "properties": {
+ "asset_id": {
+ "type": "string"
+ },
+ "asset_type": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "provider_error_code": {
+ "type": "integer"
+ },
+ "provider_error_subcode": {
+ "type": "integer"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "status": {
+ "type": "string"
+ },
+ "timing": {
+ "properties": {
+ "account_local_now": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hours_left_today": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "note": {
+ "type": "string"
+ },
+ "schedule_valid": {
+ "type": "boolean"
+ },
+ "timezone_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "utc_offset_hours": {
+ "type": "number"
+ },
+ "windows": {
+ "items": {
+ "properties": {
+ "end_time": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hours_remaining": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "hours_until_start": {
+ "type": "number"
+ },
+ "paused": {
+ "type": "boolean"
+ },
+ "potential_delivery_hours_today": {
+ "type": "number"
+ },
+ "start_time": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "version": {
+ "type": "integer"
+ },
+ "warnings": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "version",
+ "checked_at",
+ "ad_account_id",
+ "status",
+ "checks",
+ "warnings"
+ ],
+ "type": "object"
+ },
+ "publish_start_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_level": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "statuses": {
+ "properties": {
+ "ad": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "structure": {
+ "properties": {
+ "ads": {
+ "type": "integer"
+ },
+ "adsets": {
+ "type": "integer"
+ },
+ "auxiliary_writes": {
+ "type": "integer"
+ },
+ "campaigns": {
+ "type": "integer"
+ },
+ "creative_keys": {
+ "type": "integer"
+ },
+ "layouts": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "target_ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "template_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "type": "object"
+ },
+ "tool_name": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "required": [
+ "status",
+ "confirm_token",
+ "expires_at",
+ "summary"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_request"
+ ]
+ },
+ {
+ "properties": {
+ "missing_requirements": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "override_path": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "safe_to_retry_with_user_input": {
+ "const": true
+ },
+ "status": {
+ "const": "needs_input"
+ },
+ "user_instruction": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "user_instruction",
+ "safe_to_retry_with_user_input"
+ ]
+ },
+ {
+ "properties": {
+ "account_blocker_code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "account_blocker_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "automatic_retry_allowed": {
+ "type": "boolean"
+ },
+ "category": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "invalid_fields": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "manual_new_task_allowed": {
+ "type": "boolean"
+ },
+ "narrative": {
+ "properties": {
+ "details": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "headline": {
+ "type": "string"
+ },
+ "summary": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "what_happens_next": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "operator_review_required": {
+ "type": "boolean"
+ },
+ "status": {
+ "const": "blocked"
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "required": [
+ "status",
+ "narrative"
+ ]
+ }
+]Input schema / properties / request / properties / creative_source / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "oneOf": [
- {
- "anyOf": [
- {
- "properties": {
- "creative_names": {
- "minItems": 1,
- "type": "array"
- }
- },
- "required": [
- "creative_names"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "maxItems": 0
- },
- "existing_posts": {
- "maxItems": 0
- },
- "mode": {
- "const": "creative"
- },
- "partnership_rows": {
- "maxItems": 0
- }
- }
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "maxItems": 0
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "maxItems": 0
- },
- "mode": {
- "const": "partnership"
- },
- "partnership_rows": {
- "minItems": 1,
- "type": "array"
- }
- },
- "required": [
- "mode",
- "partnership_rows"
- ]
- },
- {
- "properties": {
- "carousel_groups": {
- "maxItems": 0
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "maxItems": 0
- },
- "media_mode": {
- "const": "single"
- },
- "mode": {
- "const": "template_source"
- },
- "partnership_rows": {
- "maxItems": 0
- }
- },
- "required": [
- "mode"
- ]
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "minItems": 1,
- "type": "array"
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "maxItems": 0
- },
- "mode": {
- "const": "carousel"
- },
- "partnership_rows": {
- "maxItems": 0
- }
- },
- "required": [
- "mode",
- "carousel_groups"
- ]
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "maxItems": 0
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "minItems": 1,
- "type": "array"
- },
- "media_mode": {
- "const": "single"
- },
- "mode": {
- "const": "existing_post"
- },
- "partnership_rows": {
- "maxItems": 0
- }
- },
- "required": [
- "mode",
- "existing_posts"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "carousel_groups": {
- "items": {
- "additionalProperties": false,
- "allOf": [
- {
- "required": [
- "ad_name"
- ]
- },
- {
- "properties": {
- "creative_names": {
- "minItems": 2,
- "not": {
- "type": "null"
- }
- }
- },
- "required": [
- "creative_names"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "body": {
- "maxLength": 5000,
- "type": "string"
- },
- "creative_names": {
- "items": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "maxItems": 10,
- "type": "array"
- },
- "description": {
- "maxLength": 500,
- "type": "string"
- },
- "title": {
- "maxLength": 500,
- "type": "string"
- }
- },
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "creative_names": {
- "items": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "maxItems": 50,
- "type": "array"
- },
- "creative_overrides": {
- "items": {
- "additionalProperties": false,
- "oneOf": [
- {
- "properties": {
- "creative_name": {
- "type": "string"
- }
- },
- "required": [
- "creative_name"
- ]
- }
- ],
- "properties": {
- "body": {
- "maxLength": 5000,
- "type": "string"
- },
- "creative_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "deeplink": {
- "maxLength": 2048,
- "type": "string"
- },
- "description": {
- "maxLength": 500,
- "type": "string"
- },
- "title": {
- "maxLength": 500,
- "type": "string"
- }
- },
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "existing_posts": {
- "items": {
- "additionalProperties": false,
- "allOf": [
- {
- "required": [
- "ad_name"
- ]
- },
- {
- "oneOf": [
- {
- "properties": {
- "instagram_media_id": {
- "type": "string"
- },
- "page_post_id": {
- "type": "null"
- }
- },
- "required": [
- "instagram_media_id"
- ]
- },
- {
- "properties": {
- "instagram_media_id": {
- "type": "null"
- },
- "page_post_id": {
- "type": "string"
- }
- },
- "required": [
- "page_post_id"
- ]
- }
- ]
- }
- ],
- "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "instagram_media_id": {
- "pattern": "^[0-9]{1,32}$",
- "type": "string"
- },
- "page_post_id": {
- "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
- "type": "string"
- }
- },
- "required": [
- "ad_name"
- ],
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "media_mode": {
- "enum": [
- "single",
- "multi"
- ],
- "type": "string"
- },
- "mode": {
- "default": "creative",
- "enum": [
- "creative",
- "partnership",
- "template_source",
- "carousel",
- "existing_post"
- ],
- "type": "string"
- },
- "partnership_rows": {
- "items": {
- "additionalProperties": false,
- "anyOf": [
- {
- "required": [
- "partnership_ad_id"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "deeplink": {
- "maxLength": 2048,
- "type": "string"
- },
- "original_post_url": {
- "maxLength": 2048,
- "type": "string"
- },
- "partnership_ad_id": {
- "description": "Meta partnership ad ID.",
- "maxLength": 4096,
- "minLength": 1,
- "type": "string"
- },
- "source_choice": {
- "default": "auto",
- "enum": [
- "auto",
- "new"
- ],
- "type": "string"
- },
- "source_ref": {
- "pattern": "^(ad|creative):[0-9]{1,32}$",
- "type": "string"
- }
- },
- "required": [
- "ad_name"
- ],
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- }
- },
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "media_mode": {
- "const": "single",
- "default": "single",
- "type": "string"
- },
- "media_refs": {
- "items": {
- "maxLength": 2048,
- "minLength": 16,
- "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
- "type": "string"
- },
- "maxItems": 50,
- "minItems": 1,
- "type": "array"
- },
- "mode": {
- "const": "account_media",
- "type": "string"
- }
- },
- "required": [
- "mode",
- "media_refs"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "oneOf": [
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "creative_names": {
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "required": [
+ "creative_names"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "mode": {
+ "const": "creative"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ }
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "mode": {
+ "const": "partnership"
+ },
+ "partnership_rows": {
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "required": [
+ "mode",
+ "partnership_rows"
+ ]
+ },
+ {
+ "properties": {
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "media_mode": {
+ "const": "single"
+ },
+ "mode": {
+ "const": "template_source"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ },
+ "required": [
+ "mode"
+ ]
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "minItems": 1,
+ "type": "array"
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "mode": {
+ "const": "carousel"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ },
+ "required": [
+ "mode",
+ "carousel_groups"
+ ]
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "minItems": 1,
+ "type": "array"
+ },
+ "media_mode": {
+ "const": "single"
+ },
+ "mode": {
+ "const": "existing_post"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ },
+ "required": [
+ "mode",
+ "existing_posts"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "carousel_groups": {
+ "items": {
+ "additionalProperties": false,
+ "allOf": [
+ {
+ "required": [
+ "ad_name"
+ ]
+ },
+ {
+ "properties": {
+ "creative_names": {
+ "minItems": 2,
+ "not": {
+ "type": "null"
+ }
+ }
+ },
+ "required": [
+ "creative_names"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "body": {
+ "maxLength": 5000,
+ "type": "string"
+ },
+ "card_overrides": {
+ "description": "Optional per-card title, description, link_url, cta and display_link, each matched to a card by creative_id/creative_name. A field left out falls back to this group's title/description and the template's link and CTA.",
+ "items": {
+ "additionalProperties": false,
+ "description": "Copy for one carousel card; every field left out uses the group's value.",
+ "oneOf": [
+ {
+ "properties": {
+ "creative_name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "creative_name"
+ ]
+ }
+ ],
+ "properties": {
+ "creative_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "cta": {
+ "description": "Call-to-action button. Common values: LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD, INSTALL_MOBILE_APP, GET_OFFER, SUBSCRIBE, BOOK_NOW, APPLY_NOW, CONTACT_US, SEE_DETAILS. Free text is accepted and normalised (\"Learn More\" -> LEARN_MORE); Meta has more types than are listed here. Phone, message and profile CTAs do not fit a website or app destination. Omit to keep the template's CTA.",
+ "maxLength": 100,
+ "type": "string"
+ },
+ "description": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "display_link": {
+ "description": "Display URL shown under the card (caption).",
+ "maxLength": 255,
+ "type": "string"
+ },
+ "link_url": {
+ "description": "Card landing URL.",
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "title": {
+ "description": "Card headline.",
+ "maxLength": 500,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "creative_names": {
+ "items": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "description": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 500,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "creative_names": {
+ "items": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "creative_overrides": {
+ "items": {
+ "additionalProperties": false,
+ "oneOf": [
+ {
+ "properties": {
+ "creative_name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "creative_name"
+ ]
+ }
+ ],
+ "properties": {
+ "body": {
+ "maxLength": 5000,
+ "type": "string"
+ },
+ "creative_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "deeplink": {
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "description": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 500,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "existing_posts": {
+ "items": {
+ "additionalProperties": false,
+ "allOf": [
+ {
+ "required": [
+ "ad_name"
+ ]
+ },
+ {
+ "oneOf": [
+ {
+ "properties": {
+ "instagram_media_id": {
+ "type": "string"
+ },
+ "page_post_id": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "instagram_media_id"
+ ]
+ },
+ {
+ "properties": {
+ "instagram_media_id": {
+ "type": "null"
+ },
+ "page_post_id": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "page_post_id"
+ ]
+ }
+ ]
+ }
+ ],
+ "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "instagram_media_id": {
+ "pattern": "^[0-9]{1,32}$",
+ "type": "string"
+ },
+ "page_post_id": {
+ "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ad_name"
+ ],
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "media_mode": {
+ "enum": [
+ "single",
+ "multi"
+ ],
+ "type": "string"
+ },
+ "mode": {
+ "default": "creative",
+ "enum": [
+ "creative",
+ "partnership",
+ "template_source",
+ "carousel",
+ "existing_post"
+ ],
+ "type": "string"
+ },
+ "partnership_rows": {
+ "items": {
+ "additionalProperties": false,
+ "anyOf": [
+ {
+ "required": [
+ "partnership_ad_id"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "deeplink": {
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "original_post_url": {
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "partnership_ad_id": {
+ "description": "Meta partnership ad ID.",
+ "maxLength": 4096,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source_choice": {
+ "default": "auto",
+ "enum": [
+ "auto",
+ "new"
+ ],
+ "type": "string"
+ },
+ "source_ref": {
+ "pattern": "^(ad|creative):[0-9]{1,32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ad_name"
+ ],
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "media_mode": {
+ "const": "single",
+ "default": "single",
+ "type": "string"
+ },
+ "media_refs": {
+ "items": {
+ "maxLength": 2048,
+ "minLength": 16,
+ "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
+ "type": "string"
+ },
+ "maxItems": 50,
+ "minItems": 1,
+ "type": "array"
+ },
+ "mode": {
+ "const": "account_media",
+ "type": "string"
+ }
+ },
+ "required": [
+ "mode",
+ "media_refs"
+ ],
+ "type": "object"
+ }
+]Input schema / properties / request / properties / overrides / properties / cta / descriptionAdded value: +"Call-to-action button. Common values: LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD, INSTALL_MOBILE_APP, GET_OFFER, SUBSCRIBE, BOOK_NOW, APPLY_NOW, CONTACT_US, SEE_DETAILS. Free text is accepted and normalised (\"Learn More\" -> LEARN_MORE); Meta has more types than are listed here. Phone, message and profile CTAs do not fit a website or app destination. Omit to keep the template's CTA."Input schema / properties / request / properties / overrides / properties / display_linkAdded value: +{
+ "description": "Display URL shown under single-image and carousel ads (link_data.caption). Ignored for video ads, which have no such field.",
+ "maxLength": 255,
+ "type": "string"
+}Input schema / properties / request / properties / creative_source / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "oneOf": [
- {
- "anyOf": [
- {
- "properties": {
- "creative_names": {
- "minItems": 1,
- "type": "array"
- }
- },
- "required": [
- "creative_names"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "maxItems": 0
- },
- "existing_posts": {
- "maxItems": 0
- },
- "mode": {
- "const": "creative"
- }
- }
- },
- {
- "properties": {
- "carousel_groups": {
- "maxItems": 0
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "maxItems": 0
- },
- "media_mode": {
- "const": "single"
- },
- "mode": {
- "const": "template_source"
- }
- },
- "required": [
- "mode"
- ]
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "minItems": 1,
- "type": "array"
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "maxItems": 0
- },
- "mode": {
- "const": "carousel"
- }
- },
- "required": [
- "mode",
- "carousel_groups"
- ]
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "maxItems": 0
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "minItems": 1,
- "type": "array"
- },
- "media_mode": {
- "const": "single"
- },
- "mode": {
- "const": "existing_post"
- }
- },
- "required": [
- "mode",
- "existing_posts"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "carousel_groups": {
- "items": {
- "additionalProperties": false,
- "allOf": [
- {
- "required": [
- "ad_name"
- ]
- },
- {
- "properties": {
- "creative_names": {
- "minItems": 2,
- "not": {
- "type": "null"
- }
- }
- },
- "required": [
- "creative_names"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "body": {
- "maxLength": 5000,
- "type": "string"
- },
- "creative_names": {
- "items": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "maxItems": 10,
- "type": "array"
- },
- "description": {
- "maxLength": 500,
- "type": "string"
- },
- "title": {
- "maxLength": 500,
- "type": "string"
- }
- },
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "creative_names": {
- "items": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "maxItems": 50,
- "type": "array"
- },
- "creative_overrides": {
- "items": {
- "additionalProperties": false,
- "oneOf": [
- {
- "properties": {
- "creative_name": {
- "type": "string"
- }
- },
- "required": [
- "creative_name"
- ]
- }
- ],
- "properties": {
- "body": {
- "maxLength": 5000,
- "type": "string"
- },
- "creative_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "deeplink": {
- "maxLength": 2048,
- "type": "string"
- },
- "description": {
- "maxLength": 500,
- "type": "string"
- },
- "title": {
- "maxLength": 500,
- "type": "string"
- }
- },
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "existing_posts": {
- "items": {
- "additionalProperties": false,
- "allOf": [
- {
- "required": [
- "ad_name"
- ]
- },
- {
- "oneOf": [
- {
- "properties": {
- "instagram_media_id": {
- "type": "string"
- },
- "page_post_id": {
- "type": "null"
- }
- },
- "required": [
- "instagram_media_id"
- ]
- },
- {
- "properties": {
- "instagram_media_id": {
- "type": "null"
- },
- "page_post_id": {
- "type": "string"
- }
- },
- "required": [
- "page_post_id"
- ]
- }
- ]
- }
- ],
- "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "instagram_media_id": {
- "pattern": "^[0-9]{1,32}$",
- "type": "string"
- },
- "page_post_id": {
- "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
- "type": "string"
- }
- },
- "required": [
- "ad_name"
- ],
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "media_mode": {
- "enum": [
- "single",
- "multi"
- ],
- "type": "string"
- },
- "mode": {
- "default": "creative",
- "enum": [
- "creative",
- "template_source",
- "carousel",
- "existing_post"
- ],
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "media_mode": {
- "const": "single",
- "default": "single",
- "type": "string"
- },
- "media_refs": {
- "items": {
- "maxLength": 2048,
- "minLength": 16,
- "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
- "type": "string"
- },
- "maxItems": 50,
- "minItems": 1,
- "type": "array"
- },
- "mode": {
- "const": "account_media",
- "type": "string"
- }
- },
- "required": [
- "mode",
- "media_refs"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "oneOf": [
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "creative_names": {
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "required": [
+ "creative_names"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "mode": {
+ "const": "creative"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ }
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "mode": {
+ "const": "partnership"
+ },
+ "partnership_rows": {
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "required": [
+ "mode",
+ "partnership_rows"
+ ]
+ },
+ {
+ "properties": {
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "media_mode": {
+ "const": "single"
+ },
+ "mode": {
+ "const": "template_source"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ },
+ "required": [
+ "mode"
+ ]
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "minItems": 1,
+ "type": "array"
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "mode": {
+ "const": "carousel"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ },
+ "required": [
+ "mode",
+ "carousel_groups"
+ ]
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "minItems": 1,
+ "type": "array"
+ },
+ "media_mode": {
+ "const": "single"
+ },
+ "mode": {
+ "const": "existing_post"
+ },
+ "partnership_rows": {
+ "maxItems": 0
+ }
+ },
+ "required": [
+ "mode",
+ "existing_posts"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "carousel_groups": {
+ "items": {
+ "additionalProperties": false,
+ "allOf": [
+ {
+ "required": [
+ "ad_name"
+ ]
+ },
+ {
+ "properties": {
+ "creative_names": {
+ "minItems": 2,
+ "not": {
+ "type": "null"
+ }
+ }
+ },
+ "required": [
+ "creative_names"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "body": {
+ "maxLength": 5000,
+ "type": "string"
+ },
+ "creative_names": {
+ "items": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "description": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 500,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "creative_names": {
+ "items": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "creative_overrides": {
+ "items": {
+ "additionalProperties": false,
+ "oneOf": [
+ {
+ "properties": {
+ "creative_name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "creative_name"
+ ]
+ }
+ ],
+ "properties": {
+ "body": {
+ "maxLength": 5000,
+ "type": "string"
+ },
+ "creative_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "deeplink": {
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "description": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 500,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "existing_posts": {
+ "items": {
+ "additionalProperties": false,
+ "allOf": [
+ {
+ "required": [
+ "ad_name"
+ ]
+ },
+ {
+ "oneOf": [
+ {
+ "properties": {
+ "instagram_media_id": {
+ "type": "string"
+ },
+ "page_post_id": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "instagram_media_id"
+ ]
+ },
+ {
+ "properties": {
+ "instagram_media_id": {
+ "type": "null"
+ },
+ "page_post_id": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "page_post_id"
+ ]
+ }
+ ]
+ }
+ ],
+ "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "instagram_media_id": {
+ "pattern": "^[0-9]{1,32}$",
+ "type": "string"
+ },
+ "page_post_id": {
+ "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ad_name"
+ ],
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "media_mode": {
+ "enum": [
+ "single",
+ "multi"
+ ],
+ "type": "string"
+ },
+ "mode": {
+ "default": "creative",
+ "enum": [
+ "creative",
+ "partnership",
+ "template_source",
+ "carousel",
+ "existing_post"
+ ],
+ "type": "string"
+ },
+ "partnership_rows": {
+ "items": {
+ "additionalProperties": false,
+ "anyOf": [
+ {
+ "required": [
+ "partnership_ad_id"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "deeplink": {
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "original_post_url": {
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "partnership_ad_id": {
+ "description": "Meta partnership ad ID.",
+ "maxLength": 4096,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source_choice": {
+ "default": "auto",
+ "enum": [
+ "auto",
+ "new"
+ ],
+ "type": "string"
+ },
+ "source_ref": {
+ "pattern": "^(ad|creative):[0-9]{1,32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ad_name"
+ ],
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "media_mode": {
+ "const": "single",
+ "default": "single",
+ "type": "string"
+ },
+ "media_refs": {
+ "items": {
+ "maxLength": 2048,
+ "minLength": 16,
+ "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
+ "type": "string"
+ },
+ "maxItems": 50,
+ "minItems": 1,
+ "type": "array"
+ },
+ "mode": {
+ "const": "account_media",
+ "type": "string"
+ }
+ },
+ "required": [
+ "mode",
+ "media_refs"
+ ],
+ "type": "object"
+ }
+]Output schema / else / then / properties / categoryAdded value: +{
+ "type": "string"
+}Output schema / else / then / properties / expectedAdded value: +{
+ "type": "boolean"
+}Output schema / else / then / properties / failure_kindAdded value: +{
+ "type": "string"
+}Output schema / else / then / properties / responsibility_hintAdded value: +{
+ "type": "string"
+}Output schema / else / then / properties / routeAdded value: +{
+ "type": "string"
+}Output schema / else / then / properties / user_visibleAdded value: +{
+ "type": "boolean"
+}Input schema / properties / connection_contextAdded value: +{
+ "pattern": "^mctx_v1_[0-9a-f]{64}$",
+ "type": "string"
+}Input schema / properties / request / allOfPrevious value: -[
- {
- "required": [
- "template_name"
- ]
- },
- {
- "required": [
- "creative_source"
- ]
- }
-]New value: +[
+ {
+ "required": [
+ "template_name"
+ ]
+ },
+ {
+ "properties": {
+ "creative_source": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "creative_source"
+ ]
+ }
+]Input schema / properties / request / properties / creative_source / additionalPropertiesRemoved value: -falseInput schema / properties / request / properties / creative_source / discriminatorAdded value: +{
+ "mapping": {
+ "account_media": "#/$defs/AccountMediaSource",
+ "carousel": "#/$defs/MCPCreativeSourceInput",
+ "creative": "#/$defs/MCPCreativeSourceInput",
+ "existing_post": "#/$defs/MCPCreativeSourceInput",
+ "partnership": "#/$defs/MCPCreativeSourceInput",
+ "template_source": "#/$defs/MCPCreativeSourceInput"
+ },
+ "propertyName": "mode"
+}Input schema / properties / request / properties / creative_source / oneOfPrevious value: -[
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "creative_names": {
- "minItems": 1
- },
- "mode": {
- "const": "creative"
- }
- },
- "propertyNames": {
- "pattern": "^(m|cr)"
- },
- "required": [
- "creative_names"
- ]
- },
- {
- "properties": {
- "media_mode": {
- "const": "single"
- },
- "mode": {
- "const": "template_source"
- }
- },
- "propertyNames": {
- "pattern": "^(m|a)"
- },
- "required": [
- "mode"
- ]
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "minItems": 1
- },
- "mode": {
- "const": "carousel"
- }
- },
- "propertyNames": {
- "pattern": "^(m|ca)"
- },
- "required": [
- "mode",
- "carousel_groups"
- ]
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "maxItems": 0
- },
- "creative_names": {
- "maxItems": 0
- },
- "creative_overrides": {
- "maxItems": 0
- },
- "existing_posts": {
- "minItems": 1,
- "type": "array"
- },
- "media_mode": {
- "const": "single"
- },
- "mode": {
- "const": "existing_post"
- }
- },
- "required": [
- "mode",
- "existing_posts"
- ]
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "oneOf": [
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "creative_names": {
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "required": [
+ "creative_names"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "mode": {
+ "const": "creative"
+ }
+ }
+ },
+ {
+ "properties": {
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "media_mode": {
+ "const": "single"
+ },
+ "mode": {
+ "const": "template_source"
+ }
+ },
+ "required": [
+ "mode"
+ ]
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "minItems": 1,
+ "type": "array"
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "maxItems": 0
+ },
+ "mode": {
+ "const": "carousel"
+ }
+ },
+ "required": [
+ "mode",
+ "carousel_groups"
+ ]
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "minItems": 1,
+ "type": "array"
+ },
+ "media_mode": {
+ "const": "single"
+ },
+ "mode": {
+ "const": "existing_post"
+ }
+ },
+ "required": [
+ "mode",
+ "existing_posts"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "carousel_groups": {
+ "items": {
+ "additionalProperties": false,
+ "allOf": [
+ {
+ "required": [
+ "ad_name"
+ ]
+ },
+ {
+ "properties": {
+ "creative_names": {
+ "minItems": 2,
+ "not": {
+ "type": "null"
+ }
+ }
+ },
+ "required": [
+ "creative_names"
+ ]
+ }
+ ],
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "body": {
+ "maxLength": 5000,
+ "type": "string"
+ },
+ "creative_names": {
+ "items": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "description": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 500,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "creative_names": {
+ "items": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "creative_overrides": {
+ "items": {
+ "additionalProperties": false,
+ "oneOf": [
+ {
+ "properties": {
+ "creative_name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "creative_name"
+ ]
+ }
+ ],
+ "properties": {
+ "body": {
+ "maxLength": 5000,
+ "type": "string"
+ },
+ "creative_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "deeplink": {
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "description": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 500,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "existing_posts": {
+ "items": {
+ "additionalProperties": false,
+ "allOf": [
+ {
+ "required": [
+ "ad_name"
+ ]
+ },
+ {
+ "oneOf": [
+ {
+ "properties": {
+ "instagram_media_id": {
+ "type": "string"
+ },
+ "page_post_id": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "instagram_media_id"
+ ]
+ },
+ {
+ "properties": {
+ "instagram_media_id": {
+ "type": "null"
+ },
+ "page_post_id": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "page_post_id"
+ ]
+ }
+ ]
+ }
+ ],
+ "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "instagram_media_id": {
+ "pattern": "^[0-9]{1,32}$",
+ "type": "string"
+ },
+ "page_post_id": {
+ "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ad_name"
+ ],
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+ },
+ "media_mode": {
+ "enum": [
+ "single",
+ "multi"
+ ],
+ "type": "string"
+ },
+ "mode": {
+ "default": "creative",
+ "enum": [
+ "creative",
+ "template_source",
+ "carousel",
+ "existing_post"
+ ],
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "media_mode": {
+ "const": "single",
+ "default": "single",
+ "type": "string"
+ },
+ "media_refs": {
+ "items": {
+ "maxLength": 2048,
+ "minLength": 16,
+ "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
+ "type": "string"
+ },
+ "maxItems": 50,
+ "minItems": 1,
+ "type": "array"
+ },
+ "mode": {
+ "const": "account_media",
+ "type": "string"
+ }
+ },
+ "required": [
+ "mode",
+ "media_refs"
+ ],
+ "type": "object"
+ }
+]Input schema / properties / request / properties / creative_source / propertiesRemoved value: -{
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "carousel_groups": {
- "items": {
- "additionalProperties": false,
- "allOf": [
- {
- "required": [
- "ad_name"
- ]
- },
- {
- "properties": {
- "creative_names": {
- "minItems": 2,
- "not": {
- "type": "null"
- }
- }
- },
- "required": [
- "creative_names"
- ]
- }
- ],
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "body": {
- "maxLength": 5000,
- "type": "string"
- },
- "creative_names": {
- "items": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "maxItems": 10,
- "type": "array"
- },
- "description": {
- "maxLength": 500,
- "type": "string"
- },
- "title": {
- "maxLength": 500,
- "type": "string"
- }
- },
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "creative_names": {
- "items": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "maxItems": 50,
- "type": "array"
- },
- "creative_overrides": {
- "items": {
- "additionalProperties": false,
- "oneOf": [
- {
- "properties": {
- "creative_name": {
- "type": "string"
- }
- },
- "required": [
- "creative_name"
- ]
- }
- ],
- "properties": {
- "body": {
- "maxLength": 5000,
- "type": "string"
- },
- "creative_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "deeplink": {
- "maxLength": 2048,
- "type": "string"
- },
- "description": {
- "maxLength": 500,
- "type": "string"
- },
- "title": {
- "maxLength": 500,
- "type": "string"
- }
- },
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "existing_posts": {
- "items": {
- "additionalProperties": false,
- "allOf": [
- {
- "required": [
- "ad_name"
- ]
- },
- {
- "oneOf": [
- {
- "properties": {
- "instagram_media_id": {
- "type": "string"
- },
- "page_post_id": {
- "type": "null"
- }
- },
- "required": [
- "instagram_media_id"
- ]
- },
- {
- "properties": {
- "instagram_media_id": {
- "type": "null"
- },
- "page_post_id": {
- "type": "string"
- }
- },
- "required": [
- "page_post_id"
- ]
- }
- ]
- }
- ],
- "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
- "properties": {
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "instagram_media_id": {
- "pattern": "^[0-9]{1,32}$",
- "type": "string"
- },
- "page_post_id": {
- "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
- "type": "string"
- }
- },
- "required": [
- "ad_name"
- ],
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
- },
- "media_mode": {
- "enum": [
- "single",
- "multi"
- ],
- "type": "string"
- },
- "mode": {
- "default": "creative",
- "enum": [
- "creative",
- "template_source",
- "carousel",
- "existing_post"
- ],
- "type": "string"
- }
-}Input schema / properties / request / properties / creative_source / typeRemoved value: -"object"Input schema / properties / request / properties / creative_source / oneOfPrevious value: -[
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "creative_names": {
- "minItems": 1
- },
- "mode": {
- "const": "creative"
- }
- },
- "propertyNames": {
- "pattern": "^(m|cr)"
- },
- "required": [
- "creative_names"
- ]
- },
- {
- "properties": {
- "media_mode": {
- "const": "single"
- },
- "mode": {
- "const": "template_source"
- }
- },
- "propertyNames": {
- "pattern": "^(m|a)"
- },
- "required": [
- "mode"
- ]
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "minItems": 1
- },
- "mode": {
- "const": "carousel"
- }
- },
- "propertyNames": {
- "pattern": "^(m|ca)"
- },
- "required": [
- "mode",
- "carousel_groups"
- ]
- }
-]New value: +[
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "creative_names": {
+ "minItems": 1
+ },
+ "mode": {
+ "const": "creative"
+ }
+ },
+ "propertyNames": {
+ "pattern": "^(m|cr)"
+ },
+ "required": [
+ "creative_names"
+ ]
+ },
+ {
+ "properties": {
+ "media_mode": {
+ "const": "single"
+ },
+ "mode": {
+ "const": "template_source"
+ }
+ },
+ "propertyNames": {
+ "pattern": "^(m|a)"
+ },
+ "required": [
+ "mode"
+ ]
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "minItems": 1
+ },
+ "mode": {
+ "const": "carousel"
+ }
+ },
+ "propertyNames": {
+ "pattern": "^(m|ca)"
+ },
+ "required": [
+ "mode",
+ "carousel_groups"
+ ]
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "maxItems": 0
+ },
+ "creative_names": {
+ "maxItems": 0
+ },
+ "creative_overrides": {
+ "maxItems": 0
+ },
+ "existing_posts": {
+ "minItems": 1,
+ "type": "array"
+ },
+ "media_mode": {
+ "const": "single"
+ },
+ "mode": {
+ "const": "existing_post"
+ }
+ },
+ "required": [
+ "mode",
+ "existing_posts"
+ ]
+ }
+]Input schema / properties / request / properties / creative_source / properties / existing_postsAdded value: +{
+ "items": {
+ "additionalProperties": false,
+ "allOf": [
+ {
+ "required": [
+ "ad_name"
+ ]
+ },
+ {
+ "oneOf": [
+ {
+ "properties": {
+ "instagram_media_id": {
+ "type": "string"
+ },
+ "page_post_id": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "instagram_media_id"
+ ]
+ },
+ {
+ "properties": {
+ "instagram_media_id": {
+ "type": "null"
+ },
+ "page_post_id": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "page_post_id"
+ ]
+ }
+ ]
+ }
+ ],
+ "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
+ "properties": {
+ "ad_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "instagram_media_id": {
+ "pattern": "^[0-9]{1,32}$",
+ "type": "string"
+ },
+ "page_post_id": {
+ "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ad_name"
+ ],
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+}Input schema / properties / request / properties / creative_source / properties / mode / enumPrevious value: -[
- "creative",
- "template_source",
- "carousel"
-]New value: +[
+ "creative",
+ "template_source",
+ "carousel",
+ "existing_post"
+]Output schema / else / else / anyOfPrevious value: -[
- {
- "properties": {
- "approval_request": {
- "properties": {
- "approval_ref": {
- "type": "string"
- },
- "confirm_token": {
- "type": "string"
- },
- "expires_at": {
- "type": "string"
- },
- "mode": {
- "type": "string"
- },
- "plan_digest": {
- "type": "string"
- },
- "schema_version": {
- "type": "integer"
- },
- "status": {
- "const": "approval_required"
- },
- "summary": {
- "properties": {
- "account_currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "action": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_count": {
- "type": "integer"
- },
- "ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_count": {
- "type": "integer"
- },
- "adset_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "bid": {
- "$ref": "#/$defs/s0"
- },
- "budget": {
- "$ref": "#/$defs/s0"
- },
- "campaign_count": {
- "type": "integer"
- },
- "campaign_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "change_percent": {
- "type": [
- "number",
- "null"
- ]
- },
- "copies": {
- "type": "integer"
- },
- "count": {
- "type": "integer"
- },
- "creative_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "creative_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "cross_account": {
- "type": "boolean"
- },
- "current_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "engagement_mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_type": {
- "type": [
- "string",
- "null"
- ]
- },
- "groups": {
- "items": {
- "properties": {
- "adsets": {
- "items": {
- "properties": {
- "name": {
- "type": [
- "string",
- "null"
- ]
- },
- "target_adset_id": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "bid": {
- "$ref": "#/$defs/s1"
- },
- "budget": {
- "$ref": "#/$defs/s1"
- },
- "campaign_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "layout": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "items": {
- "items": {
- "properties": {
- "ad_account_id": {
- "type": "string"
- },
- "ad_id": {
- "type": "string"
- },
- "campaign_id": {
- "type": "string"
- },
- "current_configured_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "current_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "target_configured_status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "note": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "preflight": {
- "properties": {
- "ad_account_id": {
- "type": "string"
- },
- "billing": {
- "properties": {
- "available_funds_major": {
- "type": [
- "number",
- "null"
- ]
- },
- "balance_semantics": {
- "type": "string"
- },
- "currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "low_remaining_spend_cap": {
- "type": "boolean"
- },
- "note": {
- "type": "string"
- },
- "reported_balance_major": {
- "type": [
- "number",
- "null"
- ]
- },
- "spend_cap_remaining_major": {
- "type": [
- "number",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "checked_at": {
- "type": "string"
- },
- "checks": {
- "items": {
- "properties": {
- "asset_id": {
- "type": "string"
- },
- "asset_type": {
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "status": {
- "type": "string"
- },
- "timing": {
- "properties": {
- "account_local_now": {
- "type": [
- "string",
- "null"
- ]
- },
- "hours_left_today": {
- "type": [
- "number",
- "null"
- ]
- },
- "note": {
- "type": "string"
- },
- "schedule_valid": {
- "type": "boolean"
- },
- "timezone_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "utc_offset_hours": {
- "type": "number"
- },
- "windows": {
- "items": {
- "properties": {
- "end_time": {
- "type": [
- "string",
- "null"
- ]
- },
- "hours_remaining": {
- "type": [
- "number",
- "null"
- ]
- },
- "hours_until_start": {
- "type": "number"
- },
- "paused": {
- "type": "boolean"
- },
- "potential_delivery_hours_today": {
- "type": "number"
- },
- "start_time": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "version": {
- "type": "integer"
- },
- "warnings": {
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "required": [
- "version",
- "checked_at",
- "ad_account_id",
- "status",
- "checks",
- "warnings"
- ],
- "type": "object"
- },
- "publish_start_label": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_level": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "statuses": {
- "properties": {
- "ad": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "structure": {
- "properties": {
- "ads": {
- "type": "integer"
- },
- "adsets": {
- "type": "integer"
- },
- "auxiliary_writes": {
- "type": "integer"
- },
- "campaigns": {
- "type": "integer"
- },
- "creative_keys": {
- "type": "integer"
- },
- "layouts": {
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "target_ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "template_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "type": "object"
- },
- "tool_name": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "required": [
- "status",
- "confirm_token",
- "expires_at",
- "summary"
- ],
- "type": "object"
- },
- "status": {
- "type": "string"
- }
- },
- "required": [
- "approval_request"
- ]
- },
- {
- "properties": {
- "missing_requirements": {
- "items": {
- "properties": {
- "field": {
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "override_path": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "safe_to_retry_with_user_input": {
- "const": true
- },
- "status": {
- "const": "needs_input"
- },
- "user_instruction": {
- "type": "string"
- }
- },
- "required": [
- "status",
- "user_instruction",
- "safe_to_retry_with_user_input"
- ]
- },
- {
- "properties": {
- "account_blocker_code": {
- "type": [
- "string",
- "null"
- ]
- },
- "account_blocker_label": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "automatic_retry_allowed": {
- "type": "boolean"
- },
- "category": {
- "type": [
- "string",
- "null"
- ]
- },
- "code": {
- "type": [
- "string",
- "null"
- ]
- },
- "invalid_fields": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "manual_new_task_allowed": {
- "type": "boolean"
- },
- "narrative": {
- "properties": {
- "details": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "headline": {
- "type": "string"
- },
- "summary": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "what_happens_next": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "operator_review_required": {
- "type": "boolean"
- },
- "status": {
- "const": "blocked"
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "required": [
- "status",
- "narrative"
- ]
- }
-]New value: +[
+ {
+ "properties": {
+ "approval_request": {
+ "properties": {
+ "approval_ref": {
+ "type": "string"
+ },
+ "confirm_token": {
+ "type": "string"
+ },
+ "expires_at": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "plan_digest": {
+ "type": "string"
+ },
+ "schema_version": {
+ "type": "integer"
+ },
+ "status": {
+ "const": "approval_required"
+ },
+ "summary": {
+ "properties": {
+ "account_currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "action": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_count": {
+ "type": "integer"
+ },
+ "ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_count": {
+ "type": "integer"
+ },
+ "adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "bid": {
+ "$ref": "#/$defs/s0"
+ },
+ "budget": {
+ "$ref": "#/$defs/s0"
+ },
+ "campaign_count": {
+ "type": "integer"
+ },
+ "campaign_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "change_percent": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "copies": {
+ "type": "integer"
+ },
+ "count": {
+ "type": "integer"
+ },
+ "creative_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "creative_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "cross_account": {
+ "type": "boolean"
+ },
+ "current_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "engagement_mode": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_type": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "groups": {
+ "items": {
+ "properties": {
+ "adsets": {
+ "items": {
+ "properties": {
+ "name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "target_adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "bid": {
+ "$ref": "#/$defs/s1"
+ },
+ "budget": {
+ "$ref": "#/$defs/s1"
+ },
+ "campaign_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "layout": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "items": {
+ "items": {
+ "properties": {
+ "ad_account_id": {
+ "type": "string"
+ },
+ "ad_id": {
+ "type": "string"
+ },
+ "campaign_id": {
+ "type": "string"
+ },
+ "current_configured_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "current_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "new_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "target_configured_status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "mode": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "new_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "note": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page_id_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page_id_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preflight": {
+ "properties": {
+ "ad_account_id": {
+ "type": "string"
+ },
+ "billing": {
+ "properties": {
+ "available_funds_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "balance_semantics": {
+ "type": "string"
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "low_remaining_spend_cap": {
+ "type": "boolean"
+ },
+ "note": {
+ "type": "string"
+ },
+ "reported_balance_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend_cap_remaining_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "checked_at": {
+ "type": "string"
+ },
+ "checks": {
+ "items": {
+ "properties": {
+ "asset_id": {
+ "type": "string"
+ },
+ "asset_type": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "provider_error_code": {
+ "type": "integer"
+ },
+ "provider_error_subcode": {
+ "type": "integer"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "status": {
+ "type": "string"
+ },
+ "timing": {
+ "properties": {
+ "account_local_now": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hours_left_today": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "note": {
+ "type": "string"
+ },
+ "schedule_valid": {
+ "type": "boolean"
+ },
+ "timezone_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "utc_offset_hours": {
+ "type": "number"
+ },
+ "windows": {
+ "items": {
+ "properties": {
+ "end_time": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hours_remaining": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "hours_until_start": {
+ "type": "number"
+ },
+ "paused": {
+ "type": "boolean"
+ },
+ "potential_delivery_hours_today": {
+ "type": "number"
+ },
+ "start_time": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "version": {
+ "type": "integer"
+ },
+ "warnings": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "version",
+ "checked_at",
+ "ad_account_id",
+ "status",
+ "checks",
+ "warnings"
+ ],
+ "type": "object"
+ },
+ "publish_start_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_level": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "statuses": {
+ "properties": {
+ "ad": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "structure": {
+ "properties": {
+ "ads": {
+ "type": "integer"
+ },
+ "adsets": {
+ "type": "integer"
+ },
+ "auxiliary_writes": {
+ "type": "integer"
+ },
+ "campaigns": {
+ "type": "integer"
+ },
+ "creative_keys": {
+ "type": "integer"
+ },
+ "layouts": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "target_ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "template_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "type": "object"
+ },
+ "tool_name": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "required": [
+ "status",
+ "confirm_token",
+ "expires_at",
+ "summary"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_request"
+ ]
+ },
+ {
+ "properties": {
+ "missing_requirements": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "override_path": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "safe_to_retry_with_user_input": {
+ "const": true
+ },
+ "status": {
+ "const": "needs_input"
+ },
+ "user_instruction": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "user_instruction",
+ "safe_to_retry_with_user_input"
+ ]
+ },
+ {
+ "properties": {
+ "account_blocker_code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "account_blocker_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "automatic_retry_allowed": {
+ "type": "boolean"
+ },
+ "category": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "invalid_fields": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "manual_new_task_allowed": {
+ "type": "boolean"
+ },
+ "narrative": {
+ "properties": {
+ "details": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "headline": {
+ "type": "string"
+ },
+ "summary": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "what_happens_next": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "operator_review_required": {
+ "type": "boolean"
+ },
+ "status": {
+ "const": "blocked"
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "required": [
+ "status",
+ "narrative"
+ ]
+ }
+]Output schema / else / else / anyOfPrevious value: -[
- {
- "properties": {
- "approval_request": {
- "properties": {
- "approval_ref": {
- "type": "string"
- },
- "confirm_token": {
- "type": "string"
- },
- "expires_at": {
- "type": "string"
- },
- "mode": {
- "type": "string"
- },
- "plan_digest": {
- "type": "string"
- },
- "schema_version": {
- "type": "integer"
- },
- "status": {
- "const": "approval_required"
- },
- "summary": {
- "properties": {
- "account_currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "action": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_count": {
- "type": "integer"
- },
- "ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_count": {
- "type": "integer"
- },
- "adset_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "bid": {
- "$ref": "#/$defs/s0"
- },
- "budget": {
- "$ref": "#/$defs/s0"
- },
- "campaign_count": {
- "type": "integer"
- },
- "campaign_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "change_percent": {
- "type": [
- "number",
- "null"
- ]
- },
- "copies": {
- "type": "integer"
- },
- "count": {
- "type": "integer"
- },
- "creative_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "creative_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "cross_account": {
- "type": "boolean"
- },
- "current_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "engagement_mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_type": {
- "type": [
- "string",
- "null"
- ]
- },
- "groups": {
- "items": {
- "properties": {
- "adsets": {
- "items": {
- "properties": {
- "name": {
- "type": [
- "string",
- "null"
- ]
- },
- "target_adset_id": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "bid": {
- "$ref": "#/$defs/s1"
- },
- "budget": {
- "$ref": "#/$defs/s1"
- },
- "campaign_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "layout": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "items": {
- "items": {
- "properties": {
- "ad_account_id": {
- "type": "string"
- },
- "ad_id": {
- "type": "string"
- },
- "campaign_id": {
- "type": "string"
- },
- "current_configured_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "current_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "target_configured_status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "note": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "publish_start_label": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_level": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "statuses": {
- "properties": {
- "ad": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "structure": {
- "properties": {
- "ads": {
- "type": "integer"
- },
- "adsets": {
- "type": "integer"
- },
- "auxiliary_writes": {
- "type": "integer"
- },
- "campaigns": {
- "type": "integer"
- },
- "creative_keys": {
- "type": "integer"
- },
- "layouts": {
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "target_ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "template_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "type": "object"
- },
- "tool_name": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "required": [
- "status",
- "confirm_token",
- "expires_at",
- "summary"
- ],
- "type": "object"
- },
- "status": {
- "type": "string"
- }
- },
- "required": [
- "approval_request"
- ]
- },
- {
- "properties": {
- "missing_requirements": {
- "items": {
- "properties": {
- "field": {
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "override_path": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "safe_to_retry_with_user_input": {
- "const": true
- },
- "status": {
- "const": "needs_input"
- },
- "user_instruction": {
- "type": "string"
- }
- },
- "required": [
- "status",
- "user_instruction",
- "safe_to_retry_with_user_input"
- ]
- },
- {
- "properties": {
- "account_blocker_code": {
- "type": [
- "string",
- "null"
- ]
- },
- "account_blocker_label": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "automatic_retry_allowed": {
- "type": "boolean"
- },
- "category": {
- "type": [
- "string",
- "null"
- ]
- },
- "code": {
- "type": [
- "string",
- "null"
- ]
- },
- "invalid_fields": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "manual_new_task_allowed": {
- "type": "boolean"
- },
- "narrative": {
- "properties": {
- "details": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "headline": {
- "type": "string"
- },
- "summary": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "what_happens_next": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "operator_review_required": {
- "type": "boolean"
- },
- "status": {
- "const": "blocked"
- },
- "warnings": {
- "$ref": "#/$defs/s2"
- }
- },
- "required": [
- "status",
- "narrative"
- ]
- }
-]New value: +[
+ {
+ "properties": {
+ "approval_request": {
+ "properties": {
+ "approval_ref": {
+ "type": "string"
+ },
+ "confirm_token": {
+ "type": "string"
+ },
+ "expires_at": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "plan_digest": {
+ "type": "string"
+ },
+ "schema_version": {
+ "type": "integer"
+ },
+ "status": {
+ "const": "approval_required"
+ },
+ "summary": {
+ "properties": {
+ "account_currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "action": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_count": {
+ "type": "integer"
+ },
+ "ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_count": {
+ "type": "integer"
+ },
+ "adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "bid": {
+ "$ref": "#/$defs/s0"
+ },
+ "budget": {
+ "$ref": "#/$defs/s0"
+ },
+ "campaign_count": {
+ "type": "integer"
+ },
+ "campaign_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "change_percent": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "copies": {
+ "type": "integer"
+ },
+ "count": {
+ "type": "integer"
+ },
+ "creative_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "creative_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "cross_account": {
+ "type": "boolean"
+ },
+ "current_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "engagement_mode": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_type": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "groups": {
+ "items": {
+ "properties": {
+ "adsets": {
+ "items": {
+ "properties": {
+ "name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "target_adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "bid": {
+ "$ref": "#/$defs/s1"
+ },
+ "budget": {
+ "$ref": "#/$defs/s1"
+ },
+ "campaign_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "layout": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "items": {
+ "items": {
+ "properties": {
+ "ad_account_id": {
+ "type": "string"
+ },
+ "ad_id": {
+ "type": "string"
+ },
+ "campaign_id": {
+ "type": "string"
+ },
+ "current_configured_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "current_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "new_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "target_configured_status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "mode": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "new_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "note": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page_id_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page_id_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preflight": {
+ "properties": {
+ "ad_account_id": {
+ "type": "string"
+ },
+ "billing": {
+ "properties": {
+ "available_funds_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "balance_semantics": {
+ "type": "string"
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "low_remaining_spend_cap": {
+ "type": "boolean"
+ },
+ "note": {
+ "type": "string"
+ },
+ "reported_balance_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend_cap_remaining_major": {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "checked_at": {
+ "type": "string"
+ },
+ "checks": {
+ "items": {
+ "properties": {
+ "asset_id": {
+ "type": "string"
+ },
+ "asset_type": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "status": {
+ "type": "string"
+ },
+ "timing": {
+ "properties": {
+ "account_local_now": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hours_left_today": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "note": {
+ "type": "string"
+ },
+ "schedule_valid": {
+ "type": "boolean"
+ },
+ "timezone_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "utc_offset_hours": {
+ "type": "number"
+ },
+ "windows": {
+ "items": {
+ "properties": {
+ "end_time": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hours_remaining": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "hours_until_start": {
+ "type": "number"
+ },
+ "paused": {
+ "type": "boolean"
+ },
+ "potential_delivery_hours_today": {
+ "type": "number"
+ },
+ "start_time": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "version": {
+ "type": "integer"
+ },
+ "warnings": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "version",
+ "checked_at",
+ "ad_account_id",
+ "status",
+ "checks",
+ "warnings"
+ ],
+ "type": "object"
+ },
+ "publish_start_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_level": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "statuses": {
+ "properties": {
+ "ad": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "structure": {
+ "properties": {
+ "ads": {
+ "type": "integer"
+ },
+ "adsets": {
+ "type": "integer"
+ },
+ "auxiliary_writes": {
+ "type": "integer"
+ },
+ "campaigns": {
+ "type": "integer"
+ },
+ "creative_keys": {
+ "type": "integer"
+ },
+ "layouts": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "target_ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "template_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "type": "object"
+ },
+ "tool_name": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "required": [
+ "status",
+ "confirm_token",
+ "expires_at",
+ "summary"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_request"
+ ]
+ },
+ {
+ "properties": {
+ "missing_requirements": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "override_path": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "safe_to_retry_with_user_input": {
+ "const": true
+ },
+ "status": {
+ "const": "needs_input"
+ },
+ "user_instruction": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "user_instruction",
+ "safe_to_retry_with_user_input"
+ ]
+ },
+ {
+ "properties": {
+ "account_blocker_code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "account_blocker_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "automatic_retry_allowed": {
+ "type": "boolean"
+ },
+ "category": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "invalid_fields": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "manual_new_task_allowed": {
+ "type": "boolean"
+ },
+ "narrative": {
+ "properties": {
+ "details": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "headline": {
+ "type": "string"
+ },
+ "summary": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "what_happens_next": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "operator_review_required": {
+ "type": "boolean"
+ },
+ "status": {
+ "const": "blocked"
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "required": [
+ "status",
+ "narrative"
+ ]
+ }
+]Output schema / $defs / s2Added value: +{
+ "items": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "code": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "code"
+ ]
+ },
+ {
+ "required": [
+ "message"
+ ]
+ }
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+}Output schema / else / else / anyOfPrevious value: -[
- {
- "properties": {
- "approval_request": {
- "properties": {
- "approval_ref": {
- "type": "string"
- },
- "confirm_token": {
- "type": "string"
- },
- "expires_at": {
- "type": "string"
- },
- "mode": {
- "type": "string"
- },
- "plan_digest": {
- "type": "string"
- },
- "schema_version": {
- "type": "integer"
- },
- "status": {
- "const": "approval_required"
- },
- "summary": {
- "properties": {
- "account_currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "action": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_count": {
- "type": "integer"
- },
- "ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_count": {
- "type": "integer"
- },
- "adset_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "bid": {
- "$ref": "#/$defs/s0"
- },
- "budget": {
- "$ref": "#/$defs/s0"
- },
- "campaign_count": {
- "type": "integer"
- },
- "campaign_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "change_percent": {
- "type": [
- "number",
- "null"
- ]
- },
- "copies": {
- "type": "integer"
- },
- "count": {
- "type": "integer"
- },
- "creative_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "creative_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "cross_account": {
- "type": "boolean"
- },
- "current_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "engagement_mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_type": {
- "type": [
- "string",
- "null"
- ]
- },
- "groups": {
- "items": {
- "properties": {
- "adsets": {
- "items": {
- "properties": {
- "name": {
- "type": [
- "string",
- "null"
- ]
- },
- "target_adset_id": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "bid": {
- "$ref": "#/$defs/s1"
- },
- "budget": {
- "$ref": "#/$defs/s1"
- },
- "campaign_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "layout": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "items": {
- "items": {
- "properties": {
- "ad_account_id": {
- "type": "string"
- },
- "ad_id": {
- "type": "string"
- },
- "campaign_id": {
- "type": "string"
- },
- "current_configured_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "current_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "target_configured_status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "note": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "publish_start_label": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_level": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "statuses": {
- "properties": {
- "ad": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "structure": {
- "properties": {
- "ads": {
- "type": "integer"
- },
- "adsets": {
- "type": "integer"
- },
- "auxiliary_writes": {
- "type": "integer"
- },
- "campaigns": {
- "type": "integer"
- },
- "creative_keys": {
- "type": "integer"
- },
- "layouts": {
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "target_ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "template_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "warnings": {
- "items": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "anyOf": [
- {
- "properties": {
- "code": {
- "type": "string"
- }
- },
- "required": [
- "code"
- ]
- },
- {
- "required": [
- "message"
- ]
- }
- ],
- "properties": {
- "message": {
- "type": "string"
- }
- },
- "type": "object"
- }
- ]
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "tool_name": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "warnings": {
- "items": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "anyOf": [
- {
- "properties": {
- "code": {
- "type": "string"
- }
- },
- "required": [
- "code"
- ]
- },
- {
- "required": [
- "message"
- ]
- }
- ],
- "properties": {
- "message": {
- "type": "string"
- }
- },
- "type": "object"
- }
- ]
- },
- "type": "array"
- }
- },
- "required": [
- "status",
- "confirm_token",
- "expires_at",
- "summary"
- ],
- "type": "object"
- },
- "status": {
- "type": "string"
- }
- },
- "required": [
- "approval_request"
- ]
- },
- {
- "properties": {
- "missing_requirements": {
- "items": {
- "properties": {
- "field": {
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "override_path": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "safe_to_retry_with_user_input": {
- "const": true
- },
- "status": {
- "const": "needs_input"
- },
- "user_instruction": {
- "type": "string"
- }
- },
- "required": [
- "status",
- "user_instruction",
- "safe_to_retry_with_user_input"
- ]
- }
-]New value: +[
+ {
+ "properties": {
+ "approval_request": {
+ "properties": {
+ "approval_ref": {
+ "type": "string"
+ },
+ "confirm_token": {
+ "type": "string"
+ },
+ "expires_at": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "plan_digest": {
+ "type": "string"
+ },
+ "schema_version": {
+ "type": "integer"
+ },
+ "status": {
+ "const": "approval_required"
+ },
+ "summary": {
+ "properties": {
+ "account_currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "action": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_count": {
+ "type": "integer"
+ },
+ "ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_count": {
+ "type": "integer"
+ },
+ "adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "bid": {
+ "$ref": "#/$defs/s0"
+ },
+ "budget": {
+ "$ref": "#/$defs/s0"
+ },
+ "campaign_count": {
+ "type": "integer"
+ },
+ "campaign_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "change_percent": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "copies": {
+ "type": "integer"
+ },
+ "count": {
+ "type": "integer"
+ },
+ "creative_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "creative_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "cross_account": {
+ "type": "boolean"
+ },
+ "current_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "engagement_mode": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_type": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "groups": {
+ "items": {
+ "properties": {
+ "adsets": {
+ "items": {
+ "properties": {
+ "name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "target_adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "bid": {
+ "$ref": "#/$defs/s1"
+ },
+ "budget": {
+ "$ref": "#/$defs/s1"
+ },
+ "campaign_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "layout": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "items": {
+ "items": {
+ "properties": {
+ "ad_account_id": {
+ "type": "string"
+ },
+ "ad_id": {
+ "type": "string"
+ },
+ "campaign_id": {
+ "type": "string"
+ },
+ "current_configured_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "current_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "new_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "target_configured_status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "mode": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "new_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "note": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page_id_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page_id_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "publish_start_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_level": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "statuses": {
+ "properties": {
+ "ad": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "structure": {
+ "properties": {
+ "ads": {
+ "type": "integer"
+ },
+ "adsets": {
+ "type": "integer"
+ },
+ "auxiliary_writes": {
+ "type": "integer"
+ },
+ "campaigns": {
+ "type": "integer"
+ },
+ "creative_keys": {
+ "type": "integer"
+ },
+ "layouts": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "target_ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "template_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "type": "object"
+ },
+ "tool_name": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "required": [
+ "status",
+ "confirm_token",
+ "expires_at",
+ "summary"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_request"
+ ]
+ },
+ {
+ "properties": {
+ "missing_requirements": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "override_path": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "safe_to_retry_with_user_input": {
+ "const": true
+ },
+ "status": {
+ "const": "needs_input"
+ },
+ "user_instruction": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "user_instruction",
+ "safe_to_retry_with_user_input"
+ ]
+ },
+ {
+ "properties": {
+ "account_blocker_code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "account_blocker_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "automatic_retry_allowed": {
+ "type": "boolean"
+ },
+ "category": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "invalid_fields": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "manual_new_task_allowed": {
+ "type": "boolean"
+ },
+ "narrative": {
+ "properties": {
+ "details": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "headline": {
+ "type": "string"
+ },
+ "summary": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "what_happens_next": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "operator_review_required": {
+ "type": "boolean"
+ },
+ "status": {
+ "const": "blocked"
+ },
+ "warnings": {
+ "$ref": "#/$defs/s2"
+ }
+ },
+ "required": [
+ "status",
+ "narrative"
+ ]
+ }
+]Input schema / properties / request / properties / creative_source / properties / carousel_groups / items / properties / titleAdded value: +{
+ "maxLength": 500,
+ "type": "string"
+}Input schema / properties / request / properties / creative_source / properties / creative_overridesAdded value: +{
+ "items": {
+ "additionalProperties": false,
+ "oneOf": [
+ {
+ "properties": {
+ "creative_name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "creative_name"
+ ]
+ }
+ ],
+ "properties": {
+ "body": {
+ "maxLength": 5000,
+ "type": "string"
+ },
+ "creative_name": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "deeplink": {
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "description": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 500,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "maxItems": 50,
+ "type": "array"
+}Input schema / properties / request / properties / overrides / properties / titleAdded value: +{
+ "maxLength": 500,
+ "type": "string"
+}Input schema / properties / request / properties / creative_source / properties / carousel_groups / items / properties / bodyAdded value: +{
+ "maxLength": 5000,
+ "type": "string"
+}Input schema / properties / request / properties / creative_source / properties / carousel_groups / items / properties / descriptionAdded value: +{
+ "maxLength": 500,
+ "type": "string"
+}Input schema / properties / request / properties / overrides / properties / descriptionAdded value: +{
+ "maxLength": 500,
+ "type": "string"
+}Input schema / properties / request / properties / overrides / properties / instagram_user_idAdded value: +{
+ "description": "IG ID from accounts_list_instagram_accounts; omit to inherit, empty string uses Page identity.",
+ "pattern": "^[0-9]{0,32}$",
+ "type": "string"
+}Input schema / properties / request / properties / creative_source / properties / mode / enumPrevious value: -[
- "creative",
- "partnership",
- "template_source",
- "carousel"
-]New value: +[
+ "creative",
+ "template_source",
+ "carousel"
+]Input schema / properties / request / properties / creative_source / oneOfPrevious value: -[
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "creative_names": {
- "minItems": 1
- },
- "mode": {
- "const": "creative"
- }
- },
- "propertyNames": {
- "pattern": "^(m|cr)"
- },
- "required": [
- "creative_names"
- ]
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "mode": {
- "const": "partnership"
- },
- "partnership_rows": {
- "minItems": 1
- }
- },
- "propertyNames": {
- "pattern": "^[mp]"
- },
- "required": [
- "mode",
- "partnership_rows"
- ]
- },
- {
- "properties": {
- "media_mode": {
- "const": "single"
- },
- "mode": {
- "const": "template_source"
- }
- },
- "propertyNames": {
- "pattern": "^(m|a)"
- },
- "required": [
- "mode"
- ]
- },
- {
- "properties": {
- "ad_name": {
- "type": "null"
- },
- "carousel_groups": {
- "minItems": 1
- },
- "mode": {
- "const": "carousel"
- }
- },
- "propertyNames": {
- "pattern": "^(m|ca)"
- },
- "required": [
- "mode",
- "carousel_groups"
- ]
- }
-]New value: +[
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "creative_names": {
+ "minItems": 1
+ },
+ "mode": {
+ "const": "creative"
+ }
+ },
+ "propertyNames": {
+ "pattern": "^(m|cr)"
+ },
+ "required": [
+ "creative_names"
+ ]
+ },
+ {
+ "properties": {
+ "media_mode": {
+ "const": "single"
+ },
+ "mode": {
+ "const": "template_source"
+ }
+ },
+ "propertyNames": {
+ "pattern": "^(m|a)"
+ },
+ "required": [
+ "mode"
+ ]
+ },
+ {
+ "properties": {
+ "ad_name": {
+ "type": "null"
+ },
+ "carousel_groups": {
+ "minItems": 1
+ },
+ "mode": {
+ "const": "carousel"
+ }
+ },
+ "propertyNames": {
+ "pattern": "^(m|ca)"
+ },
+ "required": [
+ "mode",
+ "carousel_groups"
+ ]
+ }
+]Input schema / properties / request / properties / creative_source / properties / partnership_rowsRemoved value: -{
- "items": {
- "additionalProperties": false,
- "properties": {
- "ad_code": {
- "maxLength": 4096,
- "minLength": 1,
- "type": "string"
- },
- "ad_name": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "deeplink": {
- "maxLength": 2048,
- "type": "string"
- }
- },
- "required": [
- "ad_code",
- "ad_name"
- ],
- "type": "object"
- },
- "maxItems": 50,
- "type": "array"
-}Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations declare readOnlyHint=false with destructiveHint=false, and the description adds a genuinely useful trait the annotations cannot convey: this only drafts, and execution happens later via launch_confirm after review. Beyond that it is silent on the large set of behavioral knobs in the schema (name_collision_policy, existing_partial_policy, activation.on_partial, creation_intent), so only partial credit over the annotation baseline.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Four short sentences, front-loaded with the core action, but they run together ('launch_confirm executes after approval Use the workflow's original link_id') and mix purpose, parameter advice, and a dangling link_id note in the same block, hurting readability.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool of this complexity the description covers the draft/approve lifecycle and the main inputs, and an output schema exists so return values need not be explained. However it omits the policies and activation semantics that materially change outcomes when appending to existing campaigns, leaving an agent under-informed before committing a draft.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is reported at 0% while the schema exposes dozens of nested fields (execution, activation, overrides, targeting, naming patterns, collision policies). The description names only ad_account_id, template, creative_source, append_mode and target IDs, and its 'original link_id' instruction refers to a field that does not appear in the schema, which can mislead. It does not compensate for the coverage gap.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (prepare new ads / append) plus the resource (campaign/ad set) and the three inputs that drive it: ad_account_id, a saved template, and one creative_source. It is distinguishable from the copy/launch siblings, though the phrasing is dense and mixes scope with parameter hints.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly routes live-ad duplication elsewhere: 'Use copy_ad_quick_copy for live-ad copies,' and frames the workflow as draft-then-'launch_confirm executes after approval.' It lacks criteria for choosing between new, append-campaign and append-adset beyond 'choose append_mode and target IDs explicitly,' so the exclusion logic for append_mode remains implicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.