Prepare 1-10 ad configured-status changes in OAuth Safe Mode. Each item needs ad_id, ad_account_id and target_configured_status=ACTIVE|PAUSED. Configured ACTIVE does not prove delivery: a parent may be paused. Review current/new values, then overview_update_confirm after approval
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes |
| Name | Required | Description | Default |
|---|---|---|---|
| message | No | ||
| retryable | No | ||
| support_ref | No |
Changes observed during successful MCP inspections.
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"
- },
- "s5": {
- "items": {
- "properties": {
- "disposition": {
- "enum": [
- "accepted",
- "excluded"
- ]
- },
- "index": {
- "type": "integer"
- },
- "operation": {
- "type": "string"
- },
- "reason": {
- "type": "string"
- },
- "reason_code": {
- "type": "string"
- },
- "suggested": {
- "items": {
- "properties": {
- "field": {
- "type": "string"
- },
- "reason_code": {
- "type": "string"
- },
- "value": {}
- },
- "type": "object"
- },
- "type": "array"
- },
- "summary": {
- "type": "object"
- }
- },
- "required": [
- "index",
- "operation",
- "summary",
- "disposition"
- ],
- "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"
- ]
- },
- "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": {
- "approval_request": {
- "properties": {
- "accepted": {
- "$ref": "#/$defs/s5"
- },
- "approval_ref": {
- "type": "string"
- },
- "confirm_tool": {
- "type": "string"
- },
- "excluded": {
- "$ref": "#/$defs/s5"
- },
- "expected_changes": {
- "$ref": "#/$defs/s5"
- },
- "expires_at": {
- "type": "string"
- },
- "instruction_template_id": {
- "type": "string"
- },
- "items": {
- "items": {
- "properties": {
- "disposition": {
- "enum": [
- "accepted",
- "excluded"
- ]
- },
- "index": {
- "type": "integer"
- },
- "operation": {
- "type": "string"
- },
- "reason": {
- "type": "string"
- },
- "reason_code": {
- "type": "string"
- },
- "receipt": {
- "type": "object"
- },
- "state": {
- "type": "string"
- },
- "suggested": {
- "items": {
- "properties": {
- "field": {
- "type": "string"
- },
- "reason_code": {
- "type": "string"
- },
- "value": {}
- },
- "type": "object"
- },
- "type": "array"
- },
- "summary": {
- "type": "object"
- }
- },
- "required": [
- "index",
- "state",
- "receipt"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "plan_digest": {
- "type": "string"
- },
- "presentation": {
- "type": "string"
- },
- "state": {
- "type": "string"
- },
- "status": {
- "type": "string"
- }
- },
- "required": [
- "state",
- "confirm_tool",
- "expected_changes",
- "accepted",
- "excluded",
- "items"
- ],
- "type": "object"
- }
- },
- "required": [
- "approval_request"
- ]
- },
- {
- "properties": {
- "accepted": {
- "$ref": "#/$defs/s5"
- },
- "approval_ref": {
- "type": "string"
- },
- "confirm_tool": {
- "type": "string"
- },
- "excluded": {
- "$ref": "#/$defs/s5"
- },
- "expected_changes": {
- "$ref": "#/$defs/s5"
- },
- "expires_at": {
- "type": "string"
- },
- "instruction_template_id": {
- "type": "string"
- },
- "items": {
- "items": {
- "properties": {
- "disposition": {
- "enum": [
- "accepted",
- "excluded"
- ]
- },
- "index": {
- "type": "integer"
- },
- "operation": {
- "type": "string"
- },
- "reason": {
- "type": "string"
- },
- "reason_code": {
- "type": "string"
- },
- "receipt": {
- "type": "object"
- },
- "state": {
- "type": "string"
- },
- "suggested": {
- "items": {
- "properties": {
- "field": {
- "type": "string"
- },
- "reason_code": {
- "type": "string"
- },
- "value": {}
- },
- "type": "object"
- },
- "type": "array"
- },
- "summary": {
- "type": "object"
- }
- },
- "required": [
- "index",
- "state",
- "receipt"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "plan_digest": {
- "type": "string"
- },
- "presentation": {
- "type": "string"
- },
- "state": {
- "type": "string"
- },
- "status": {
- "type": "string"
- }
- },
- "required": [
- "state",
- "confirm_tool",
- "expected_changes",
- "accepted",
- "excluded",
- "items"
- ]
- }
-]New value: +[
+ {
+ "required": [
+ "approval_request"
+ ]
+ },
+ {
+ "required": [
+ "accepted",
+ "confirm_tool",
+ "excluded",
+ "expected_changes",
+ "items",
+ "state"
+ ]
+ }
+]Output schema / else / else / propertiesAdded value: +{
+ "accepted": {
+ "items": {
+ "properties": {
+ "disposition": {
+ "enum": [
+ "accepted",
+ "excluded"
+ ]
+ },
+ "index": {
+ "type": "integer"
+ },
+ "operation": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "suggested": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "value": {}
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "summary": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "index",
+ "operation",
+ "summary",
+ "disposition"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "approval_ref": {
+ "type": "string"
+ },
+ "approval_request": {
+ "anyOf": [
+ {
+ "properties": {
+ "status": {
+ "const": "approval_required"
+ }
+ },
+ "required": [
+ "confirm_token",
+ "expires_at",
+ "status",
+ "summary"
+ ]
+ },
+ {
+ "required": [
+ "accepted",
+ "confirm_tool",
+ "excluded",
+ "expected_changes",
+ "items",
+ "state"
+ ]
+ }
+ ],
+ "properties": {
+ "accepted": {
+ "items": {
+ "properties": {
+ "disposition": {
+ "enum": [
+ "accepted",
+ "excluded"
+ ]
+ },
+ "index": {
+ "type": "integer"
+ },
+ "operation": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "suggested": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "value": {}
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "summary": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "index",
+ "operation",
+ "summary",
+ "disposition"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "approval_ref": {
+ "type": "string"
+ },
+ "confirm_token": {
+ "type": "string"
+ },
+ "confirm_tool": {
+ "type": "string"
+ },
+ "excluded": {
+ "items": {
+ "properties": {
+ "disposition": {
+ "enum": [
+ "accepted",
+ "excluded"
+ ]
+ },
+ "index": {
+ "type": "integer"
+ },
+ "operation": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "suggested": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "value": {}
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "summary": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "index",
+ "operation",
+ "summary",
+ "disposition"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "expected_changes": {
+ "items": {
+ "properties": {
+ "disposition": {
+ "enum": [
+ "accepted",
+ "excluded"
+ ]
+ },
+ "index": {
+ "type": "integer"
+ },
+ "operation": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "suggested": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "value": {}
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "summary": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "index",
+ "operation",
+ "summary",
+ "disposition"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "expires_at": {
+ "type": "string"
+ },
+ "instruction_template_id": {
+ "type": "string"
+ },
+ "items": {
+ "items": {
+ "properties": {
+ "disposition": {
+ "enum": [
+ "accepted",
+ "excluded"
+ ]
+ },
+ "index": {
+ "type": "integer"
+ },
+ "operation": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "receipt": {
+ "type": "object"
+ },
+ "state": {
+ "type": "string"
+ },
+ "suggested": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "value": {}
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "summary": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "index",
+ "state",
+ "receipt"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "plan_digest": {
+ "type": "string"
+ },
+ "presentation": {
+ "type": "string"
+ },
+ "schema_version": {
+ "type": "integer"
+ },
+ "state": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ },
+ "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"
+ ]
+ },
+ "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"
+ }
+ },
+ "type": "object"
+ },
+ "confirm_tool": {
+ "type": "string"
+ },
+ "excluded": {
+ "items": {
+ "properties": {
+ "disposition": {
+ "enum": [
+ "accepted",
+ "excluded"
+ ]
+ },
+ "index": {
+ "type": "integer"
+ },
+ "operation": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "suggested": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "value": {}
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "summary": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "index",
+ "operation",
+ "summary",
+ "disposition"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "expected_changes": {
+ "items": {
+ "properties": {
+ "disposition": {
+ "enum": [
+ "accepted",
+ "excluded"
+ ]
+ },
+ "index": {
+ "type": "integer"
+ },
+ "operation": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "suggested": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "value": {}
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "summary": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "index",
+ "operation",
+ "summary",
+ "disposition"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "expires_at": {
+ "type": "string"
+ },
+ "instruction_template_id": {
+ "type": "string"
+ },
+ "items": {
+ "items": {
+ "properties": {
+ "disposition": {
+ "enum": [
+ "accepted",
+ "excluded"
+ ]
+ },
+ "index": {
+ "type": "integer"
+ },
+ "operation": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "receipt": {
+ "type": "object"
+ },
+ "state": {
+ "type": "string"
+ },
+ "suggested": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "value": {}
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "summary": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "index",
+ "state",
+ "receipt"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "plan_digest": {
+ "type": "string"
+ },
+ "presentation": {
+ "type": "string"
+ },
+ "state": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ }
+}Output schema / $defs / s5Added value: +{
+ "items": {
+ "properties": {
+ "disposition": {
+ "enum": [
+ "accepted",
+ "excluded"
+ ]
+ },
+ "index": {
+ "type": "integer"
+ },
+ "operation": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "suggested": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "value": {}
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "summary": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "index",
+ "operation",
+ "summary",
+ "disposition"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}Output schema / else / else / anyOfAdded 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"
+ ]
+ },
+ "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": {
+ "approval_request": {
+ "properties": {
+ "accepted": {
+ "$ref": "#/$defs/s5"
+ },
+ "approval_ref": {
+ "type": "string"
+ },
+ "confirm_tool": {
+ "type": "string"
+ },
+ "excluded": {
+ "$ref": "#/$defs/s5"
+ },
+ "expected_changes": {
+ "$ref": "#/$defs/s5"
+ },
+ "expires_at": {
+ "type": "string"
+ },
+ "instruction_template_id": {
+ "type": "string"
+ },
+ "items": {
+ "items": {
+ "properties": {
+ "disposition": {
+ "enum": [
+ "accepted",
+ "excluded"
+ ]
+ },
+ "index": {
+ "type": "integer"
+ },
+ "operation": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "receipt": {
+ "type": "object"
+ },
+ "state": {
+ "type": "string"
+ },
+ "suggested": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "value": {}
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "summary": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "index",
+ "state",
+ "receipt"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "plan_digest": {
+ "type": "string"
+ },
+ "presentation": {
+ "type": "string"
+ },
+ "state": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "state",
+ "confirm_tool",
+ "expected_changes",
+ "accepted",
+ "excluded",
+ "items"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "approval_request"
+ ]
+ },
+ {
+ "properties": {
+ "accepted": {
+ "$ref": "#/$defs/s5"
+ },
+ "approval_ref": {
+ "type": "string"
+ },
+ "confirm_tool": {
+ "type": "string"
+ },
+ "excluded": {
+ "$ref": "#/$defs/s5"
+ },
+ "expected_changes": {
+ "$ref": "#/$defs/s5"
+ },
+ "expires_at": {
+ "type": "string"
+ },
+ "instruction_template_id": {
+ "type": "string"
+ },
+ "items": {
+ "items": {
+ "properties": {
+ "disposition": {
+ "enum": [
+ "accepted",
+ "excluded"
+ ]
+ },
+ "index": {
+ "type": "integer"
+ },
+ "operation": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "receipt": {
+ "type": "object"
+ },
+ "state": {
+ "type": "string"
+ },
+ "suggested": {
+ "items": {
+ "properties": {
+ "field": {
+ "type": "string"
+ },
+ "reason_code": {
+ "type": "string"
+ },
+ "value": {}
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "summary": {
+ "type": "object"
+ }
+ },
+ "required": [
+ "index",
+ "state",
+ "receipt"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "plan_digest": {
+ "type": "string"
+ },
+ "presentation": {
+ "type": "string"
+ },
+ "state": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "state",
+ "confirm_tool",
+ "expected_changes",
+ "accepted",
+ "excluded",
+ "items"
+ ]
+ }
+]Output schema / else / else / propertiesRemoved value: -{
- "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"
- }
-}Output schema / else / else / requiredRemoved value: -[
- "approval_request"
-]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 / items / items / allOfAdded value: +[
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "ad_id": {
+ "not": {
+ "type": "null"
+ }
+ }
+ },
+ "required": [
+ "ad_id"
+ ]
+ },
+ {
+ "properties": {
+ "entity_id": {
+ "not": {
+ "type": "null"
+ }
+ }
+ },
+ "required": [
+ "entity_id"
+ ]
+ }
+ ]
+ },
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "target_configured_status": {
+ "not": {
+ "type": "null"
+ }
+ }
+ },
+ "required": [
+ "target_configured_status"
+ ]
+ },
+ {
+ "properties": {
+ "status": {
+ "not": {
+ "type": "null"
+ }
+ }
+ },
+ "required": [
+ "status"
+ ]
+ }
+ ]
+ }
+]Input schema / properties / items / items / propertiesAdded value: +{
+ "ad_account_id": {
+ "description": "Public ad_account_id from the same ad's read result.",
+ "type": [
+ "string",
+ "number"
+ ]
+ },
+ "ad_id": {
+ "description": "Exact ad_id from the selected read result; no duplicates.",
+ "type": [
+ "string",
+ "number",
+ "null"
+ ]
+ },
+ "entity_id": {
+ "description": "Legacy alias for ad_id; prefer ad_id.",
+ "type": [
+ "string",
+ "number",
+ "null"
+ ]
+ },
+ "status": {
+ "description": "Legacy alias for target_configured_status; if both are set they must agree.",
+ "pattern": "^\\s*(?:[Aa][Cc][Tt][Ii][Vv][Ee]|[Pp][Aa][Uu][Ss][Ee][Dd])\\s*$",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "target_configured_status": {
+ "anyOf": [
+ {
+ "enum": [
+ "ACTIVE",
+ "PAUSED"
+ ],
+ "type": "string"
+ },
+ {
+ "pattern": "^\\s*(?:[Aa][Cc][Tt][Ii][Vv][Ee]|[Pp][Aa][Uu][Ss][Ee][Dd])\\s*$",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ ],
+ "description": "Desired configured state; ACTIVE does not guarantee effective delivery."
+ }
+}Input schema / properties / items / items / requiredAdded value: +[
+ "ad_account_id"
+]Input schema / properties / items / maxItemsAdded value: +10Input schema / properties / items / minItemsAdded value: +1Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already establish that this is a non-read-only but non-destructive operation; the description adds valuable context about OAuth Safe Mode, the 1-10 item limit, and the caveat that configured ACTIVE does not guarantee delivery. It still omits failure/partial-success behavior, but the added behavioral context is strong.
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?
The description is short, front-loaded with the action and batch limit, and every sentence carries useful guidance. There is no redundant repetition of the tool name or schema.
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?
Given the annotations, detailed nested input schema, and presence of an output schema, the description supplies what an agent needs: the prepare/confirm workflow, item requirements, batch limits, and a key delivery caveat. No critical calling information is missing.
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?
The description adds meaning by stating the item requirements and the 1-10 batch size, while the nested schema documents aliases and constraints. It does not mention the legacy alias fields, but it covers the primary parameter semantics clearly.
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?
The description states a specific verb and resource: preparing ad configured-status changes. It also distinguishes the action from the confirmation step by naming overview_update_confirm, so an agent can route correctly among the update/confirm workflow tools.
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?
It clearly describes the prepare step and the subsequent overview_update_confirm after approval, and tells the agent to review current/new values. It does not explicitly state when not to use this tool or name an alternative beyond the confirm step, so it falls short of a full 5.
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.