RArainbrand
Brands

Create a brand

Build reusable brand context from your sources. Check progress with Get a brand.

post/brands

Request

  • Base URL
    https://www.rainbrand.com/api/v1
  • URL
    https://www.rainbrand.com/api/v1/brands
  • Auth
    • API key in header x-api-key
    • or HTTP bearer
    • or OAuth 2
      Authorization code: https://www.rainbrand.com/api/auth/oauth2/authorize
      Token URL: https://www.rainbrand.com/api/auth/oauth2/token

Headers

idempotency-keystring

Optional retry key, 1–255 characters after trimming. Reuse with the same request to recover the original Brand ID. Use a new key for a new creation.

Request body

instructionsstring

Optional instructions passed to the Brand Agent for this run. The Agent applies them using its existing judgment.

workspaceIdstring

Team workspace ID. The brand is created in that workspace and billed to its customer. Omit to create in the caller's personal workspace.

allowDuplicateboolean

Allow creation when a website or Instagram source matches an existing brand in the selected workspace. Set to true only when the caller intentionally chooses to create another brand. Defaults to false.

Example request

{
  "sources": [
    {
      "kind": "website",
      "url": "https://acme.com"
    }
  ]
}

Response

OK

Changes

No recorded changes to this operation across all 2 revisions of this API.