Preview policy decisions and execution diffs for a proposed Action batch without writing it.
View input schema
{
"type": "object",
"properties": {
"limit": {
"description": "Maximum complete result actions; the shared JSON byte budget can return fewer.",
"default": 25,
"minimum": 1,
"maximum": 100,
"type": "integer"
},
"cursor": {
"description": "Continue using next_cursor. Read saved proposal actions with get_action_batch to avoid another write; dry runs repeat the same inputs.",
"minimum": 0,
"type": "integer"
},
"actions": {
"minItems": 1,
"maxItems": 25,
"items": {
"anyOf": [
{
"properties": {
"type": {
"enum": [
"increase_budget"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"pattern": "^[0-9]+$",
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"properties": {
"new_daily_budget_minor": {
"description": "Daily budget in Meta budget units for the account currency: whole units for CLP, COP, CRC, HUF, IDR, ISK, JPY, KRW, PYG, TWD and VND, and hundredths of a unit for every other currency Meta lists, including BHD and JOD.",
"minimum": 1,
"type": "integer"
}
},
"type": "object",
"required": [
"new_daily_budget_minor"
]
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"decrease_budget"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"pattern": "^[0-9]+$",
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"properties": {
"new_daily_budget_minor": {
"description": "Daily budget in Meta budget units for the account currency: whole units for CLP, COP, CRC, HUF, IDR, ISK, JPY, KRW, PYG, TWD and VND, and hundredths of a unit for every other currency Meta lists, including BHD and JOD.",
"minimum": 1,
"type": "integer"
}
},
"type": "object",
"required": [
"new_daily_budget_minor"
]
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"pause"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"pattern": "^[0-9]+$",
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"resume"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"pattern": "^[0-9]+$",
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"create_campaign"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"create_ad_set"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"create_ad"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"upload_asset"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"properties": {
"staged_asset_id": {
"maxLength": 255,
"pattern": "^stage_[a-f0-9]{40}$",
"type": "string"
},
"asset_type": {
"enum": [
"image"
],
"type": "string"
},
"filename": {
"maxLength": 255,
"type": "string"
},
"content_sha256": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"mime_type": {
"maxLength": 255,
"type": [
"string",
"null"
]
},
"size_bytes": {
"minimum": 1,
"type": [
"integer",
"null"
]
}
},
"type": "object",
"required": [
"staged_asset_id",
"asset_type",
"filename",
"content_sha256"
]
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"duplicate_ad_with_creative"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"properties": {
"asset_id": {
"maxLength": 255,
"pattern": "^(image|video):.+$",
"type": "string"
},
"status": {
"enum": [
"paused"
],
"type": "string"
},
"name_suffix": {
"maxLength": 100,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"asset_id",
"status"
]
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
}
]
},
"type": "array"
},
"rationale": {
"maxLength": 4000,
"type": "string"
},
"idempotency_key": {
"maxLength": 64,
"type": "string"
},
"evidence": {
"minItems": 1,
"maxItems": 3,
"items": {
"additionalProperties": false,
"properties": {
"source_tool": {
"description": "Evidence source name. staged-asset-manifest is the server-held manifest of a staged upload. Cite it with action_index set to the upload_asset action whose staged_asset_id and content_sha256 it matches. It is not a callable tool.",
"enum": [
"get_account_state",
"get_signal_health",
"get_performance",
"get_inventory_metrics",
"get-creative-library",
"staged-asset-manifest"
],
"type": "string"
},
"fields_used": {
"minItems": 1,
"maxItems": 50,
"items": {
"maxLength": 255,
"type": "string"
},
"type": "array"
},
"action_index": {
"minimum": 0,
"type": "integer"
}
},
"type": "object",
"required": [
"source_tool",
"fields_used"
]
},
"type": "array"
},
"target_source": {
"enum": [
"human_supplied"
],
"type": "string"
},
"account_id": {
"minimum": 1,
"type": "integer"
},
"workspace_id": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"actions",
"rationale",
"idempotency_key",
"evidence",
"target_source"
]
}