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

**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_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
- [create_update_microsoft_ads_ad](https://metadata.io/developers/tools/create_update_microsoft_ads_ad) Destructive

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