MMetadata /docs
⌘K
Docs/Tools/regenerate_flexible_background

regenerate_flexible_background

Regenerate ONLY the background scene of a flexible creative, keeping the editable text/logo layers untouched.

Destructive creative

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

What it does

Regenerate ONLY the background scene of a flexible creative, keeping the editable text/logo layers untouched. Returns the new background image URL so the editor swaps just the background layer.

USE FOR: "regenerate the background", "try a different scene", "new background, same text".

Accepts an optional image_source (the current background) to guide a same-style regeneration; omit it for a fresh scene.

Arguments

ArgumentTypeNotes
domain string required Company domain for brand DNA (e.g. 'metadata.io'). No protocol.
instructions string required Direction for the new background scene.
platform string Target platform (sets the default aspect ratio). Default: 'linkedin'.
one of: linkedin, facebook, instagram, reddit, display, general
aspect_ratio string Pass the creative's own canvas.aspect_ratio so the new background keeps its shape. Omitting it on a non-default canvas reshapes the creative and the existing layers no longer fit.
one of: 1:1, 16:9, 9:16, 4:5
image_source string Optional URL of the current background to guide a same-style regeneration (image-to-image). Omit for a fresh scene.
background_hex string Optional 6-digit hex to pin the dominant background color (e.g. '#0A2540').

Request

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":"regenerate_flexible_background","arguments":{"domain":"<domain>","instructions":"<instructions>"}}}'

Response

No recorded response. This tool can delete, archive, launch or move budget, so it is never executed to build these docs. The request above is still the exact shape to send. Nothing on this page is invented.

Other creative tools:

All 160 tools · machine-readable index