# Rainbrand

> Documentation for Rainbrand, the brand layer for agents.

- [Introduction](https://docs.rainbrand.com/introduction.md): Brand infrastructure for agents and products.
- [MCP quickstart](https://docs.rainbrand.com/mcp/getting-started.md): Connect your agents, add a brand, and give them its context.
- [Embed Rainbrand into your product](https://docs.rainbrand.com/getting-started/embed-into-your-product.md): Manage, edit, and deploy your customers' brands with our brand infrastructure.
- [Tools](https://docs.rainbrand.com/mcp/tools.md): Rainbrand MCP tools and their guides.
- [Add a brand](https://docs.rainbrand.com/guides/create-brand.md): Add your brand from files, links, and written guidance.
- [Edit a brand](https://docs.rainbrand.com/guides/edit-brand.md): Update your brand's guidance and identity, then review the changes before applying them.
- [Manage the Brand Library](https://docs.rainbrand.com/guides/manage-brand-library.md): Keep the assets that represent your brand available to your agents.
- [Upload local files](https://docs.rainbrand.com/guides/upload-files.md): Give your agents access to local files through Rainbrand's file picker.
- [Use a Brand Skill](https://docs.rainbrand.com/guides/use-brand-skill.md): Retrieve or export a complete snapshot of your brand's guidance and assets.
- [Explore a Brand Skill](https://docs.rainbrand.com/explore-brand-skill.md): A complete Brand Skill for TANNIN, a tea-room concept.
- [Request a Brief](https://docs.rainbrand.com/guides/request-brief.md): A Brief is the subset of your brand's guidance and assets relevant to a specific task.
- [Use the AI Gateway](https://docs.rainbrand.com/guides/use-ai-gateway.md): Access SOTA models through your Rainbrand connection.
- [Use your own generation tools](https://docs.rainbrand.com/guides/use-your-own-generation-tools.md): Use Rainbrand's guidance and assets with your existing models and generation tools.
- [Request a Review](https://docs.rainbrand.com/guides/request-review.md): Check an asset against your brand and use the findings to guide revisions.
- [Troubleshooting](https://docs.rainbrand.com/mcp/troubleshooting.md): Resolve connection problems, stalled tasks, and file-access issues with your agents.
- [Report a problem](https://docs.rainbrand.com/guides/report-feedback.md): Tell the Rainbrand team what happened without interrupting your agents' task.
- [API quickstart](https://docs.rainbrand.com/api/quickstart.md): Add a brand and retrieve guidance for a task through the REST API.
- [Authentication](https://docs.rainbrand.com/api/authentication.md): Authenticate server requests with an API key or connect users through OAuth.
- [Credits and limits](https://docs.rainbrand.com/api/usage-limits.md): Request budgets, credit reservations, and how to handle billing failures.
- [OpenAPI specification](https://docs.rainbrand.com/api/openapi.md): Download the REST contract to generate clients, import requests, or inspect schemas.
- [Versioning and deprecation](https://docs.rainbrand.com/api/versioning.md): Current REST API support, compatibility, and endpoint migration guidance.
- [Errors](https://docs.rainbrand.com/api/errors.md): Read failed API responses and handle errors by code.
- [Create a brand](https://docs.rainbrand.com/api-reference/brands/create-a-brand.md): Build reusable brand context from your sources. Check progress with [Get a brand](/api-reference/brands/get-a-brand).
- [Get a brand](https://docs.rainbrand.com/api-reference/brands/get-a-brand.md): Read the brand's current profile and active Brand Skill version, or check progress while it is being prepared.
- [List brands](https://docs.rainbrand.com/api-reference/brands/list-brands.md): List the brands you can access.
- [Delete a brand](https://docs.rainbrand.com/api-reference/brands/delete-a-brand.md): Remove the brand from your account and cancel its running tasks. This cannot be undone.
- [Create a Brand Edit](https://docs.rainbrand.com/api-reference/brands/create-a-brand-edit.md): Prepare proposed changes without changing the active brand. Inspect progress and the proposal with [Get a Brand Edit](/api-reference/brands/get-a-brand-edit).
- [Get a Brand Edit](https://docs.rainbrand.com/api-reference/brands/get-a-brand-edit.md): Check a Brand Edit's progress, requested input, and proposed changes. Inspect the full text with [Get a changed brand file](/api-reference/brands/get-a-changed-brand-file).
- [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](/api-reference/brands/get-a-brand-edit).
- [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 it. Check the result with [Get a Brand Edit](/api-reference/brands/get-a-brand-edit).
- [Apply a Brand Edit](https://docs.rainbrand.com/api-reference/brands/apply-a-brand-edit.md): Make the proposed guidance and profile active. A stale edit cannot be applied. [Create a new edit](/api-reference/brands/create-a-brand-edit) from the current brand version.
- [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.
- [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](/api-reference/brands/create-a-brand-edit); uploading it alone does not change the brand.
- [Add to a Brand Library](https://docs.rainbrand.com/api-reference/library/add-to-a-brand-library.md): Save a file in the brand's asset collection. 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.
- [Search Library images](https://docs.rainbrand.com/api-reference/images/search-library-images.md): Find Brand Library images by what they depict, such as product photos or packaging. Generated images are excluded.
- [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.
- [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. For a ZIP, [export the Brand Skill](/api-reference/brands/export-a-brand-skill).
- [Export a Brand Skill](https://docs.rainbrand.com/api-reference/brands/export-a-brand-skill.md): Prepare a downloadable ZIP of the active Brand Skill. Retrieve the download with [Get a Brand Skill export](/api-reference/brands/get-a-brand-skill-export).
- [Get a Brand Skill export](https://docs.rainbrand.com/api-reference/brands/get-a-brand-skill-export.md): Check an export and download its ZIP when ready. The export stays tied to the Brand Skill selected when it was requested.
- [Request a Brief](https://docs.rainbrand.com/api-reference/briefs/request-a-brief.md): Prepare brand guidance and selected assets for a specific task. Retrieve the result with [Get a Brief](/api-reference/briefs/get-a-brief).
- [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.
- [Start a generation](https://docs.rainbrand.com/api-reference/generations/start-a-generation.md): Generate a file with a selected model. A Brand ID scopes the request; pass a completed Brief to a supported model to include brand guidance and assets. Retrieve outputs with [Get a generation](/api-reference/generations/get-a-generation).
- [Get a generation](https://docs.rainbrand.com/api-reference/generations/get-a-generation.md): Retrieve a generation's status, outputs, or failure details.
- [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.
- [List models](https://docs.rainbrand.com/api-reference/models/list-models.md): Find a model for the type of file you want to create, then read its input schema before generating.
- [Get a model](https://docs.rainbrand.com/api-reference/models/get-a-model.md): Read the input schema for a chosen model.
- [Request a Review](https://docs.rainbrand.com/api-reference/reviews/request-a-review.md): Check an asset against a brand's guidance. Retrieve the findings with [Get a Review](/api-reference/reviews/get-a-review).
- [Get a Review](https://docs.rainbrand.com/api-reference/reviews/get-a-review.md): Read a Review's progress and completed findings.
- [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 an image](https://docs.rainbrand.com/api-reference/images/delete-an-image.md): Permanently delete an image. This cannot be undone.
- [Delete images](https://docs.rainbrand.com/api-reference/images/delete-images.md): Permanently delete the selected images. This cannot be undone.
- [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.
- [Upload files](https://docs.rainbrand.com/api-reference/uploads/upload-files.md): Make local files available to Rainbrand requests, such as Acme Inc.'s brand guide or an Atlas Pro product photo.
- [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.
- [List workspaces](https://docs.rainbrand.com/api-reference/account/list-workspaces.md): Find your personal account and teams. Use a team's ID as workspaceId when creating a brand, staging uploads, or reading its credit balance.
- [Get credit balance](https://docs.rainbrand.com/api-reference/account/get-credit-balance.md): Read the credit balance and action costs for your personal account or a team. See [Credits and limits](/api/usage-limits) for billing and recovery.
- [Submit feedback](https://docs.rainbrand.com/api-reference/feedback/submit-feedback.md): Report a problem or observation about Rainbrand for internal review. Continue the original task after submitting.
- [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 campaign directions and generate a consistent set 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): Plan a short video from a Rainbrand Brief, render it through Rainbrand's AI Gateway, and have your agent review the result.
- [Create an on-brand UGC video](https://docs.rainbrand.com/use-cases/ugc-video.md): Use a Rainbrand Brief and selected product references 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 a Rainbrand Brief 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 a Rainbrand Brief's guidance and selected assets with a coding agent to create motion graphics.
- [Create a launch deck in Paper](https://docs.rainbrand.com/use-cases/launch-deck-in-paper.md): Use a Rainbrand Brief and Paper to make and export a short branded presentation with a connected agent.
- [Create editable SVG illustrations](https://docs.rainbrand.com/use-cases/editable-svg-illustrations.md): Use a Rainbrand Brief's guidance and references to generate editable SVG illustrations with Quiver Arrow 2 in Paper.

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