# Rainbrand

> Documentation for Rainbrand, the brand layer for agents.

- [Introduction](https://docs.rainbrand.com/introduction.md): Give agents and applications the brand context they need to create on-brand work.
- [How Rainbrand works](https://docs.rainbrand.com/how-rainbrand-works.md): Develop brand context that agents and applications can use and update.
- [Explore a Brand Skill](https://docs.rainbrand.com/explore-brand-skill.md): Read the TANNIN example Brand Skill, inspect its visual references and editable assets, and download the complete folder.
- [API quickstart](https://docs.rainbrand.com/api/index.md): Make your first generation through the API in six steps.
- [MCP quickstart](https://docs.rainbrand.com/mcp/getting-started.md): Connect an agent to Rainbrand and generate your first brand-aware image.
- [Upload local files](https://docs.rainbrand.com/guides/upload-files.md): Upload a local file to use as a brand source or an asset.
- [Manage the Brand Library](https://docs.rainbrand.com/guides/manage-brand-library.md): Add, list, and remove a brand's images, video, and audio.
- [Create a brand](https://docs.rainbrand.com/guides/create-brand.md): Create a brand from your sources and use its context through the API or MCP.
- [Edit a brand](https://docs.rainbrand.com/guides/edit-brand.md): Prepare, inspect, refine, and apply changes to a brand through the API or MCP.
- [Retrieve and use a Brand Skill](https://docs.rainbrand.com/guides/use-brand-skill.md): Retrieve the active Brand Skill and apply its guidance and assets in another system.
- [Export a Brand Skill](https://docs.rainbrand.com/guides/export-brand-skill.md): Download a portable ZIP of a Brand Skill and its assets.
- [Request a Brief](https://docs.rainbrand.com/guides/request-brief.md): Get the brand guidance and files that apply to what you are about to make.
- [Request a Review](https://docs.rainbrand.com/guides/request-review.md): Check an asset against your brand and use the findings to guide revisions.
- [Use cases](https://docs.rainbrand.com/use-cases.md): See finished images, web pages, emails, videos, illustrations, and presentations made using Rainbrand's brand guidance and assets.
- [Create a campaign image set](https://docs.rainbrand.com/use-cases/campaign-image-set.md): Use an MCP-connected agent and Rainbrand to explore three campaign directions, select one, and resize it for social and web.
- [Build an on-brand web page](https://docs.rainbrand.com/use-cases/web-page.md): Use Rainbrand's brand guidance and assets to build a responsive, client-facing web page in your existing web stack.
- [Create a branded product video](https://docs.rainbrand.com/use-cases/product-video.md): Use a brand in Rainbrand and a connected agent to plan, render, and review a short video through Rainbrand MCP.
- [Create an on-brand UGC video](https://docs.rainbrand.com/use-cases/ugc-video.md): Use a connected agent, Rainbrand's brand guidance, and product photos to make a creator-style video with Seedance 2.5.
- [Build an on-brand campaign email](https://docs.rainbrand.com/use-cases/campaign-email.md): Use Rainbrand's brand guidance and assets to create a responsive HTML email you can adapt in your email platform.
- [Create branded motion graphics](https://docs.rainbrand.com/use-cases/motion-graphics.md): Use Rainbrand's brand guidance, fonts, and assets with a coding agent to create motion graphics for different brands.
- [Create a launch deck in Paper](https://docs.rainbrand.com/use-cases/launch-deck-in-paper.md): Use an MCP-connected agent, Rainbrand's brand guidance, and Paper to make and export a short branded presentation.
- [Create editable SVG illustrations](https://docs.rainbrand.com/use-cases/editable-svg-illustrations.md): Use Rainbrand's brand guidance and references to generate editable SVG illustrations with Quiver Arrow 2 in Paper.
- [Connect Rainbrand](https://docs.rainbrand.com/mcp/connect.md): Connect each agent to Rainbrand MCP — sign in with Rainbrand, or use a static API key.
- [Available tools](https://docs.rainbrand.com/mcp/tools.md): Find the Rainbrand MCP capability for your task.
- [Troubleshooting](https://docs.rainbrand.com/mcp/troubleshooting.md): Diagnose Rainbrand MCP connection, validation, lifecycle, billing, and rate-limit failures.
- [API overview](https://docs.rainbrand.com/api/openapi.md): The complete public REST contract and its live OpenAPI specification.
- [Authentication](https://docs.rainbrand.com/api/authentication.md): How to authenticate requests to the Rainbrand API.
- [Credits and limits](https://docs.rainbrand.com/api/usage-limits.md): Credits, rate limits, and plan behavior shared by the Rainbrand API and MCP.
- [List brands](https://docs.rainbrand.com/api-reference/brands/list-brands.md): List the brands you can access.
- [Create a brand](https://docs.rainbrand.com/api-reference/brands/create-a-brand.md): Create a brand and its Brand Skill from your sources. See [Create a brand](/guides/create-brand) to choose sources, start creation, and handle retries or an existing brand.
- [Get a brand](https://docs.rainbrand.com/api-reference/brands/get-a-brand.md): Read a brand's current profile and check whether it is ready to use. See [Create a brand](/guides/create-brand) for creation and recovery.
- [Delete a brand](https://docs.rainbrand.com/api-reference/brands/delete-a-brand.md): Delete a brand.
- [Inspect a Brand Skill](https://docs.rainbrand.com/api-reference/brands/inspect-a-brand-skill.md): Retrieve the complete active Brand Skill as an immutable snapshot of the brand's profile, guidance, and assets. See [Use a Brand Skill](/guides/use-brand-skill).
- [Export a Brand Skill](https://docs.rainbrand.com/api-reference/brands/export-a-brand-skill.md): Prepare a downloadable ZIP of the brand's active Brand Skill. See [Export a Brand Skill](/guides/export-brand-skill).
- [Get a Brand Skill export](https://docs.rainbrand.com/api-reference/brands/get-a-brand-skill-export.md): Check a [Brand Skill export](/guides/export-brand-skill) and download its ZIP when ready. The export stays tied to the Skill selected when it was requested.
- [Create a Brand Edit](https://docs.rainbrand.com/api-reference/brands/create-a-brand-edit.md): Prepare proposed changes to a brand without changing its active guidance or profile. See [Edit a brand](/guides/edit-brand) to prepare, review, and apply changes.
- [Upload a brand font](https://docs.rainbrand.com/api-reference/brands/upload-a-brand-font.md): Upload a custom font for use in a Brand Edit; uploading it alone does not change the brand. See [Upload local files](/guides/upload-files) for the font workflow.
- [Get a Brand Edit](https://docs.rainbrand.com/api-reference/brands/get-a-brand-edit.md): Check a Brand Edit's progress, see any requested input, or inspect its proposed changes. See [Edit a brand](/guides/edit-brand) for the workflow.
- [Get a changed brand file](https://docs.rainbrand.com/api-reference/brands/get-a-changed-brand-file.md): Read the original and proposed versions of a file to inspect a [Brand Edit](/guides/edit-brand).
- [Continue a Brand Edit](https://docs.rainbrand.com/api-reference/brands/continue-a-brand-edit.md): Answer a Brand Edit's request for input so preparation can continue without applying the edit. See [Edit a brand](/guides/edit-brand) for the workflow.
- [Apply a Brand Edit](https://docs.rainbrand.com/api-reference/brands/apply-a-brand-edit.md): Activate the prepared candidate as the active brand.
- [Discard a Brand Edit](https://docs.rainbrand.com/api-reference/brands/discard-a-brand-edit.md): Discard a Brand Edit without changing the active brand.
- [Add to a Brand Library](https://docs.rainbrand.com/api-reference/library/add-to-a-brand-library.md): Add an image, video, or audio file from an upload, existing media, or a URL. Identical file contents return the existing item. Images are up to 10 MiB; video and audio (beta) up to 100 MiB.
- [List a Brand Library](https://docs.rainbrand.com/api-reference/library/list-a-brand-library.md): List the images, video, and audio in a brand's Library, most recently added first. Briefs, Brand Edits, and Brand Skills can draw on Library images; video and audio stay stored for other workflows.
- [Remove from a Brand Library](https://docs.rainbrand.com/api-reference/library/remove-from-a-brand-library.md): Take a file out of a brand's Library without deleting it. Future Briefs, Brand Edits, and Brand Skill versions stop using it; published Brand Skills keep working. To delete the file, use its media family's delete endpoint.
- [List models](https://docs.rainbrand.com/api-reference/models/list-models.md): Discover available generation models. Filter by type or query, and use limit and cursor to page through results.
- [Get a model](https://docs.rainbrand.com/api-reference/models/get-a-model.md): Read the input schema for a chosen model.
- [Start a generation](https://docs.rainbrand.com/api-reference/generations/start-a-generation.md): Start a generation with a model you choose.
- [List generations](https://docs.rainbrand.com/api-reference/generations/list-generations.md): List your generations, newest first. Outputs that were later deleted stay listed with available set to false.
- [Get a generation](https://docs.rainbrand.com/api-reference/generations/get-a-generation.md): Retrieve a generation's status, outputs, or failure details.
- [Semantic search](https://docs.rainbrand.com/api-reference/images/semantic-search.md): Find visually similar images in a brand's Brand Library, excluding generated images.
- [List images](https://docs.rainbrand.com/api-reference/images/list-images.md): Browse images from one brand or across your brands.
- [Get an image](https://docs.rainbrand.com/api-reference/images/get-an-image.md): Retrieve an image and its current status.
- [Delete images](https://docs.rainbrand.com/api-reference/images/delete-images.md): Delete multiple images in one request.
- [Delete an image](https://docs.rainbrand.com/api-reference/images/delete-an-image.md): Delete an image.
- [List videos](https://docs.rainbrand.com/api-reference/videos/list-videos.md): List videos across your brands, newest first.
- [Get a video file](https://docs.rainbrand.com/api-reference/videos/get-a-video-file.md): Read one video file by media ID.
- [Delete a video file](https://docs.rainbrand.com/api-reference/videos/delete-a-video-file.md): Permanently delete one video file. This cannot be undone.
- [List audio files](https://docs.rainbrand.com/api-reference/audio/list-audio-files.md): List audio files across your brands, newest first.
- [Get an audio file](https://docs.rainbrand.com/api-reference/audio/get-an-audio-file.md): Read one audio file by media ID.
- [Delete an audio file](https://docs.rainbrand.com/api-reference/audio/delete-an-audio-file.md): Permanently delete one audio file. This cannot be undone.
- [Request a Brief](https://docs.rainbrand.com/api-reference/briefs/request-a-brief.md): Prepare brand guidance and selected assets for a specific task. See [Request a Brief](/guides/request-brief) for examples and the workflow.
- [Get a Brief](https://docs.rainbrand.com/api-reference/briefs/get-a-brief.md): Get a Brief's current status and, when complete, its Markdown guidance and selected assets.
- [Request a Review](https://docs.rainbrand.com/api-reference/reviews/request-a-review.md): Check an asset against a brand's guidance. See [Request a Review](/guides/request-review) for examples and the workflow.
- [Get a Review](https://docs.rainbrand.com/api-reference/reviews/get-a-review.md): Read a Review's progress and completed findings.
- [Upload files](https://docs.rainbrand.com/api-reference/uploads/upload-files.md): Reserve temporary storage for local files without adding them to a brand. See [Upload local files](/guides/upload-files) for the upload workflow.
- [Get account](https://docs.rainbrand.com/api-reference/account/get-account.md): Return basic profile information for the authenticated user. Use it as a `whoami` check to verify which account the credentials belong to.
- [Get credit balance](https://docs.rainbrand.com/api-reference/account/get-credit-balance.md): Check a workspace's remaining credits and what each credit-priced action costs it.
- [List workspaces](https://docs.rainbrand.com/api-reference/account/list-workspaces.md): List the workspaces you can access.

## OpenAPI Specs

- [spec](https://www.rainbrand.com/api/v1/spec.json)


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