> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suprsonic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get account settings, branding, and customer avatars

> Returns comprehensive account configuration including settings, branding, and customer personas for blog rendering and content generation



## OpenAPI

````yaml get /api/v1/settings
openapi: 3.1.0
info:
  title: SuprSonic API
  version: 1.0.0
  description: API for autonomous content generation and blog management
  contact:
    name: SuprSonic API Support
    url: https://www.suprsonic.com/support
    email: support@suprsonic.com
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://www.suprsonic.com
    description: Production server
  - url: http://localhost:3000
    description: Development server
security: []
tags: []
paths:
  /api/v1/settings:
    get:
      tags:
        - Settings
      summary: Get account settings, branding, and customer avatars
      description: >-
        Returns comprehensive account configuration including settings,
        branding, and customer personas for blog rendering and content
        generation
      parameters:
        - in: query
          name: account_id
          required: false
          schema:
            type: string
          description: >-
            Account ID (required for admin API keys, ignored for account API
            keys)
      responses:
        '200':
          description: Account settings retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      account:
                        type: object
                        description: Account information
                        properties:
                          id:
                            type: string
                            format: uuid
                          name:
                            type: string
                          slug:
                            type: string
                          email:
                            type: string
                            format: email
                          created_at:
                            type: string
                            format: date-time
                      businessInfo:
                        type: object
                        description: Business information and content preferences
                        properties:
                          business_name:
                            type: string
                          business_description:
                            type: string
                          content_strategy:
                            type: string
                            nullable: true
                          keyword_targets:
                            type: string
                            nullable: true
                          tone_of_voice:
                            type: string
                          topics_to_avoid:
                            type: string
                            nullable: true
                            description: >-
                              Topics to avoid in content generation
                              (comma-separated or free text)
                          website_url:
                            type: string
                            format: uri
                            nullable: true
                          primary_language:
                            type: string
                            description: >-
                              Primary language for content creation and
                              generation
                            example: en
                            default: en
                          translation_languages:
                            type: array
                            description: >-
                              Additional languages to automatically translate
                              content into at publish time
                            items:
                              type: string
                              example: es
                            maxItems: 10
                            example:
                              - es
                              - fr
                              - de
                      branding:
                        type: object
                        description: Account branding (colors, fonts, styling)
                        properties:
                          primary_color:
                            type: string
                            pattern: ^#[0-9A-F]{6}$
                          font_display:
                            type: string
                          font_body:
                            type: string
                          style_density:
                            type: string
                            enum:
                              - compact
                              - medium
                              - spacious
                          corner_radius:
                            type: string
                            enum:
                              - sharp
                              - rounded
                              - pill
                          logo_url:
                            type: string
                            format: uri
                            nullable: true
                          subdomain_slug:
                            type: string
                          custom_domain:
                            type: string
                            nullable: true
                          ssl_enabled:
                            type: boolean
                          domain_verified:
                            type: boolean
                      customerAvatars:
                        type: array
                        description: Customer personas/avatars for content targeting
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            name:
                              type: string
                            description:
                              type: string
                            priority:
                              type: integer
                              minimum: 1
                              maximum: 100
                              description: >-
                                Priority level for content generation (1-100,
                                higher numbers = higher priority)
                            cta_headline:
                              type: string
                              nullable: true
                            cta_subheadline:
                              type: string
                              nullable: true
                            cta_button:
                              type: string
                              nullable: true
                            cta_url:
                              type: string
                              format: uri
                              nullable: true
                            created_at:
                              type: string
                              format: date-time
                            updated_at:
                              type: string
                              format: date-time
        '401':
          description: Unauthorized
        '500':
          description: Internal server error
      security:
        - BearerAuth: []
components: {}

````