Request a Brief

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

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

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.

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.

With your API key, submit the brand and task:

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:

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 and Get a Brief for the full contract.

Connect your agent, then ask:

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.

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 for error and access rules.

Getting started

Guides

Use cases

MCP

What the Brief contains

Request and retrieve a Brief

If the Brief is not ready

​What the Brief contains

​Request and retrieve a Brief

​If the Brief is not ready

What the Brief contains

Request and retrieve a Brief

If the Brief is not ready