#635 — Whitelabel Configuration API Endpoints

Repo: Twill-AI/facade State: closed | Status: done Assignee: meliascosta

Created: 2025-10-08 · Updated: 2025-10-13

Description

Create REST API endpoints for partners to manage their whitelabel configuration including branding assets, custom domains, and retrieval of configuration for frontend. AC:

• GET /api/v1/whitelabel/config - Returns config for current hostname

  • Public endpoint (no auth required)
  • Returns partner branding, colors, logo/favicon URLs
  • Returns default Twill config if no partner found or config not set

• GET /api/v1/partner/whitelabel - Get partner’s own config

  • Requires PartnerGrantedFor() authentication
  • Returns full whitelabel configuration
  • Includes domain and email config status

• PUT /api/v1/partner/whitelabel/branding - Update branding

  • Requires PartnerGrantedFor() authentication
  • Accepts logo_url, favicon_url, primary_color, secondary_color, company_name
  • Validates hex color format
  • Creates config if doesn’t exist, updates if exists
  • Returns updated configuration

• POST /api/v1/partner/whitelabel/domains - Add custom domain

  • Requires PartnerGrantedFor() authentication
  • Accepts domain string
  • Validates domain format
  • Generates CNAME target
  • Returns DNS setup instructions
  • Prevents duplicate domains

• GET /api/v1/partner/whitelabel/domains - List domains

  • Returns all domains for partner with verification status

• All endpoints have proper error handling

• All endpoints available to both the partner and master

• OpenAPI documentation generated

• Integratio

Notes

Add implementation notes, blockers, and context here

Related

Add wikilinks to related people, meetings, or other tickets