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

# Request a Brief

> Get the brand guidance and files that apply to what you are about to make.

A Brief gives your agent the brand context it needs for the task at hand.

<Note>
  This feature is in beta. During beta, endpoint schemas and behavior may change
  or be removed.
</Note>

## What the Brief contains

Rainbrand returns written guidance and selected assets relevant to your task, such as logos, images, and fonts. Give these to the agent or application making the output, along with your original task. Your tools handle layout and production.

Anyone with a Brief's asset URL can open it without signing in. Share these links only with people and tools you trust.

Rainbrand selects brand context without inventing unstated project details. For a general overview, [read the Brand Skill](/guides/use-brand-skill).

## Request and retrieve a Brief

You'll need a ready brand with an active Brand Skill. Describe your task, including any audience or constraints that matter.

<Tabs>
  <Tab title="API">
    With your [API key](/api/authentication), submit the brand and task:

    ```bash theme={"dark"}
    curl -X POST https://www.rainbrand.com/api/v1/briefs \
      -H "x-api-key: $RAINBRAND_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: q3-investor-deck-1" \
      -d '{
        "brandSessionId": "<brand_session_id>",
        "task": "An investor slide deck about our Q3 launch, covering the Pro line, EU expansion, and retention."
      }'
    ```

    Replace the Brand ID. The `202` response contains `data.id` and `data.status`. Set `BRIEF_ID` to that ID:

    ```bash theme={"dark"}
    curl "https://www.rainbrand.com/api/v1/briefs/$BRIEF_ID?wait=true&timeout=120" \
      -H "x-api-key: $RAINBRAND_API_KEY"
    ```

    Repeat this read while `pending` or `processing`. Once `completed`, read `data.guidance` and `data.assets`. See [Request a Brief](/api-reference/briefs/request-a-brief) and [Get a Brief](/api-reference/briefs/get-a-brief) for the full contract.
  </Tab>

  <Tab title="MCP">
    [Connect your agent](/mcp/connect), then ask:

    ```text theme={"dark"}
    Request a Rainbrand brief for our Q3 investor deck, covering the Pro
    line, EU expansion, and retention. Use the Acme brand. Show me the guidance
    and selected files before making the deck.
    ```

    The agent requests the Brief, waits for it to complete, and shows the guidance and selected files.
  </Tab>
</Tabs>

## If the Brief is not ready

Keep reading the same Brief while it is pending or processing, including after a wait times out. If a create response is lost, retry with the same input and idempotency key to avoid creating another Brief.

If the Brief fails, read its error message before retrying. A task that brand context cannot help with needs a revised request. See the [Brief reference](/api-reference/briefs/get-a-brief) for error and access rules.


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