> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rainbrand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate image generation

> Move from managed image generation to a chosen model and its native input.

This guide applies to managed image requests sent to `POST /api/v1/images/generations` with a top-level `prompt`. Move these requests to `POST /api/v1/generations` with `brandSessionId`, an exact `model` ID, and `input` matching that model's schema.

When migrating an existing integration:

* For brand-specific images, request and inspect a completed Brief, then pass
  its ID as `briefId` with your prompt and controls to a supported image model.
  The Brief must belong to you and the same brand as `brandSessionId`.
* Replace model tiers with an exact model ID. Read its schema before mapping prompts, sizes, aspect ratios, or references.
* Read the returned generation ID with `GET /generations/{id}`. A completed generation returns files in `outputs`; it can contain more than one.

The [API quickstart](/api/index.md) shows the complete request and retrieval flow.

## MCP clients

Refresh `tools/list` to replace cached tool definitions. Use `list_models`, `get_model`, `generate_image`, and `get_generation` for image generation, following their current schemas.

## Existing integrations

Old managed image requests retain their previous behavior and return `Deprecation` and `Link` headers pointing to this guide. No retirement date has been announced.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.