API reference

Brand

The brand kit, image library, and memories.

Update the brand kit

PATCH/v1/public/brand

scopesbrand:write

Structured fields only (description, industry, audience, tone, colors, keywords). Channel handles and internal fields stay in the app.

Body

description	string	What the business is, in a sentence or two
industry	string	Industry the business operates in
targetAudience	string	Who the content is for
toneOfVoice	enum: professional \| friendly \| bold \| casual \| playful[]	Tone-of-voice descriptors (the app can only render these values)
colors	object	The full palette (all three)
keywords	string[]	Words and phrases the brand leans on

request

curl -X PATCH https://api.taka.ai/v1/public/brand \
  -H "Authorization: Bearer taka_live_..." \
  -H "Content-Type: application/json" \
  -d '{"description": "Neighborhood bakery, open since 2014", "toneOfVoice": ["professional"]}'

response

{
  "businessName": "Sunrise Bakery",
  "industry": "Bakery",
  "description": "Neighborhood bakery, open since 2014",
  "targetAudience": "Locals within walking distance",
  "toneOfVoice": [
    "professional"
  ],
  "colors": {
    "primary": "#1a1a2e",
    "secondary": "#e94560",
    "accent": "#0f3460"
  },
  "colorsConfigured": true,
  "fonts": {
    "heading": "Inter",
    "body": "Inter"
  },
  "fontsConfigured": true,
  "logoUrl": "https://media.taka.ai/logo-abc123.png?signature=...",
  "keywords": [
    "bakery"
  ],
  "websiteUrl": "https://sunrisebakery.example",
  "timezone": "America/New_York",
  "images": [
    {
      "attachmentId": "abc123",
      "url": "https://media.taka.ai/abc123.jpg?signature=...",
      "tags": [
        "product"
      ]
    }
  ]
}

Brand kit

GET/v1/public/brand

scopesbrand:read

Colors, fonts, tone, keywords, logo, and the brand image library. Image URLs are signed and expire after ~6 hours.

request

curl https://api.taka.ai/v1/public/brand \
  -H "Authorization: Bearer taka_live_..."

response

{
  "businessName": "Sunrise Bakery",
  "industry": "Bakery",
  "description": "Neighborhood bakery, open since 2014",
  "targetAudience": "Locals within walking distance",
  "toneOfVoice": [
    "professional"
  ],
  "colors": {
    "primary": "#1a1a2e",
    "secondary": "#e94560",
    "accent": "#0f3460"
  },
  "colorsConfigured": true,
  "fonts": {
    "heading": "Inter",
    "body": "Inter"
  },
  "fontsConfigured": true,
  "logoUrl": "https://media.taka.ai/logo-abc123.png?signature=...",
  "keywords": [
    "bakery"
  ],
  "websiteUrl": "https://sunrisebakery.example",
  "timezone": "America/New_York",
  "images": [
    {
      "attachmentId": "abc123",
      "url": "https://media.taka.ai/abc123.jpg?signature=...",
      "tags": [
        "product"
      ]
    }
  ]
}

Set the brand logo from an uploaded attachment

PUT/v1/public/brand/logo

scopesbrand:write

Sets the brand logo from an uploaded attachment id (upload via POST /media first).

Body

attachmentIdrequired

string

Attachment id of an uploaded image

request

curl -X PUT https://api.taka.ai/v1/public/brand/logo \
  -H "Authorization: Bearer taka_live_..." \
  -H "Content-Type: application/json" \
  -d '{"attachmentId": "abc123"}'

response

{
  "businessName": "Sunrise Bakery",
  "industry": "Bakery",
  "description": "Neighborhood bakery, open since 2014",
  "targetAudience": "Locals within walking distance",
  "toneOfVoice": [
    "professional"
  ],
  "colors": {
    "primary": "#1a1a2e",
    "secondary": "#e94560",
    "accent": "#0f3460"
  },
  "colorsConfigured": true,
  "fonts": {
    "heading": "Inter",
    "body": "Inter"
  },
  "fontsConfigured": true,
  "logoUrl": "https://media.taka.ai/logo-abc123.png?signature=...",
  "keywords": [
    "bakery"
  ],
  "websiteUrl": "https://sunrisebakery.example",
  "timezone": "America/New_York",
  "images": [
    {
      "attachmentId": "abc123",
      "url": "https://media.taka.ai/abc123.jpg?signature=...",
      "tags": [
        "product"
      ]
    }
  ]
}

Brand memories

GET/v1/public/brand/memories

scopesbrand:read

Durable facts and timely notes that steer generated content.

request

curl https://api.taka.ai/v1/public/brand/memories \
  -H "Authorization: Bearer taka_live_..."

response

{
  "memories": [
    {
      "id": "abc123",
      "kind": "fact",
      "text": "We never discount",
      "expiresAt": "2026-09-01T09:30:00Z"
    }
  ]
}

Add a brand memory (a durable fact)

POST/v1/public/brand/memories

scopesbrand:write

Adds a durable brand fact that steers future generated content (for example, closed on Mondays).

Body

textrequired

string

A durable brand fact (e.g. "We never discount")

request

curl -X POST https://api.taka.ai/v1/public/brand/memories \
  -H "Authorization: Bearer taka_live_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "We never discount"}'

response

{
  "id": "abc123",
  "kind": "fact",
  "text": "We never discount",
  "expiresAt": "2026-09-01T09:30:00Z"
}

Remove a brand memory

DELETE/v1/public/brand/memories/{memoryId}

scopesbrand:write

Removes a brand memory.

Path and query parameters

memoryIdrequired

string

Brand memory id

request

curl -X DELETE https://api.taka.ai/v1/public/brand/memories/MEMORY_ID \
  -H "Authorization: Bearer taka_live_..."

response

// 204 No Content

Brand image library

GET/v1/public/brand/images

scopesbrand:read

Real brand photos with content tags. Use an attachmentId with posts/{id}/set-image. URLs are signed and expire (~6h).

request

curl https://api.taka.ai/v1/public/brand/images \
  -H "Authorization: Bearer taka_live_..."

response

{
  "images": [
    {
      "attachmentId": "abc123",
      "url": "https://media.taka.ai/abc123.jpg?signature=...",
      "tags": [
        "product"
      ]
    }
  ]
}