Skip to main content
GET
/
api
/
workspace
/
{workspaceId}
/
brands
/
{brandId}
/
ai-specs
Get brand AI specifications
curl --request GET \
  --url https://app.alana.shopping/api/workspace/{workspaceId}/brands/{brandId}/ai-specs \
  --header 'Authorization: Bearer <token>'
{
  "id": "specs_1a2b3c",
  "brand_id": "brand_1a2b3c",
  "tone_of_voice": "Professional yet approachable",
  "brand_objective": "Empower businesses with premium tools",
  "target_audience": "B2B SaaS companies with 50-500 employees",
  "content_policies": "No clickbait, avoid superlatives",
  "language_preferences": "US English",
  "keywords_always": [
    "premium",
    "efficiency"
  ],
  "keywords_never": [
    "cheap",
    "discount"
  ],
  "custom_instructions": "Always emphasize ROI and productivity",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-02-10T14:22:00Z"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication via Auth0. Users authenticate through Auth0 Universal Login. Include the access token in the Authorization header: Authorization: Bearer <token>

Path Parameters

​
workspaceId
string
required

The workspace ID

Pattern: ^ws_[a-z0-9]+$
​
brandId
string
required

Response

Brand AI specifications retrieved successfully

​
id
string
required
​
brand_id
string
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
tone_of_voice
string | null
​
brand_objective
string | null
​
target_audience
string | null
​
content_policies
string | null
​
language_preferences
string | null
​
keywords_always
string[] | null
​
keywords_never
string[] | null
​
custom_instructions
string | null
​
visual_style
string | null

Visual aesthetic style (e.g. minimalist, lifestyle, editorial, studio). Migrated from workspaces.brand_style_profile.

Maximum string length: 50
​
color_palette
string[] | null

Brand hex color codes. Max 10 items.

Maximum array length: 10
Pattern: ^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
​
default_ai_tier
enum<string> | null

Default AI generation quality tier.

Available options:
economic,
balanced,
high,
null
Last modified on February 16, 2026