---
title: "regenerate_flexible_background. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/regenerate_flexible_background
description: "Regenerate ONLY the background scene of a flexible creative, keeping the editable text/logo layers untouched. Destructive tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# regenerate_flexible_background

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

Destructive [creative](https://metadata.io/developers/tools/#cat-creative)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `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 |   | The creative's channel (its document's `channel`); without aspect_ratio it also picks the shape, the channel's default. 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. Omitted, the channel's default shape is used (the one a new creative takes), which reshapes a creative made in another shape so its layers no longer fit. On a channel's canvas the new background comes back at that canone of: `1:1`, `1.91:1`, `4:5`, `9:16`, `16:9`, `4:3`, `6: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'). |
| `characters` | array |   | The brand characters the new background must show. Omit to keep the ones image_source shows; for a fresh scene pass the creative's provenance.quality.characters. [] drops them all. |

## 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.

## Response

## Related

Other creative tools:

- [archive_ad](https://metadata.io/developers/tools/archive_ad) Destructive
- [create_update_carousel_ad](https://metadata.io/developers/tools/create_update_carousel_ad) Destructive
- [create_update_convo_ad](https://metadata.io/developers/tools/create_update_convo_ad) Destructive
- [create_update_ctv_ad](https://metadata.io/developers/tools/create_update_ctv_ad) Destructive
- [create_update_document_ad](https://metadata.io/developers/tools/create_update_document_ad) Destructive
- [create_update_google_ads_ad](https://metadata.io/developers/tools/create_update_google_ads_ad) Destructive
- [create_update_image_ad](https://metadata.io/developers/tools/create_update_image_ad) Destructive
- [create_update_linkedin_message_ad](https://metadata.io/developers/tools/create_update_linkedin_message_ad) Destructive

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)