MMetadata /docs
Docs/Tools/fix_flexible_creative

fix_flexible_creative

Apply a free-text AI edit to a flexible creative's BACKGROUND image and return the edited image URL.

Destructive creative

Deletes, archives, launches or moves budget. Do not give an agent this one without a human gate.

What it does

Apply a free-text AI edit to a flexible creative's BACKGROUND image and return the edited image URL. Instruction-based image-to-image edit (like edit_brand_creative), scoped to the background so the crisp editable text/logo layers are never touched.

USE FOR: "remove the glare", "make the sky warmer", "clean up the left side", "swap the desk for a laptop".

OUTPUT: the edited background image URL (the editor swaps the background layer).

Arguments

ArgumentTypeNotes
image_source string required URL of the background image to edit (PNG/JPG/WebP). Typically the flexible creative's current background.
edit_instruction string required Natural-language description of the fix(es). Can combine several changes in one request.
domain string required Company domain for brand context (e.g. 'metadata.io').

Request

Request template, not a complete runnable example. Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fix_flexible_creative","arguments":{"image_source":"<image_source>","edit_instruction":"<edit_instruction>","domain":"<domain>"}}}'

Response

No recorded response. This tool can delete, archive, launch or move budget, so it is never executed to build these docs. The request is an illustrative template. Fill required fields and check the current schema before calling it. No response is fabricated.

Other creative tools:

Browse the tool catalog · machine-readable index