---
title: "POST /async-tasks/generate-site-with-ai"
method: POST
path: "/async-tasks/generate-site-with-ai"
---

# POST /async-tasks/generate-site-with-ai

`POST /async-tasks/generate-site-with-ai`

## Request body

- object
  - `additional_ai_context` object
    - `instructions` string — Can only be used in conjunction with the template_alias property, otherwise the endpoint will return an error. Add additional context to the AI to generate content based on your preferences e.g., "Generate images of food only, don’t incorporate people" or "On the services page include the keywords bread, bakery"
    - `max_pages` integer — Number of pages to be generated. Minimum is 1, Maximum is 10. It is recommended to exclude the pages property if this integer is provided. If the pages array is provided along with this integer, the pages array length must match the value of this property or an error will be returned. Should not be used in conjunction with the template_alias property.
    - `pages` object[] — A list of pages to include in the site. It is recommended to exclude the max_pages property if this array is provided. If the max_pages property is provided along with this array, the max_pages integer must match the length of this array or an error will be returned. Minimum length of the array is 1, Maximum is 10. Should not be used in conjunction with the template_alias property.
      - `description` string — Optional, but highly recommended, description of the page. The AI will use this information to generate page content. Maximum of 10,000 characters.
      - `title` string, required — Maximum of 40 characters.
  - `business_data` object
    - `category` string, required — The category of the business. Max 500 characters.
    - `data_controller` string — The name of the person or organization determining the means by which the data is processed. Used for GDPR.
    - `description` string, required — Max 5000 characters.
    - `logo_url` string
    - `name` string, required
    - `service_area` string — Max 500 characters.
    - `tone_of_voice` string — One of CONVERSATIONAL, HUMOROUS, ENTHUSIASTIC, INFORMATIVE, PROFESSIONAL, WITTY or AUTHORITATIVE.
  - `default_domain_prefix` string — Must be between 4-44 characters long.
  - `do_not_gen_ssl` boolean
  - `labels` object[]
    - `name` string
  - `lang` string
  - `site_data` object
    - `external_uid` string
    - `google_tracking_id` string
    - `googletagmanager_container_id` string[] — Max of three IDs.
    - `site_alternate_domains` object
      - `domains` string[]
      - `is_redirect` boolean
    - `site_business_info` object
      - `address` object
        - `city` string
        - `country` string
        - `state` string
        - `street` string
        - `zip_code` string
      - `business_name` string
      - `email` string
      - `phone_number` string
    - `site_domain` string
    - `site_seo` object
      - `description` string
      - `no_index` boolean
      - `og_image` string
      - `title` string
  - `template_alias` string — A unique identifier tied to an editor 2.0 template. If this property is included in the request payload the site design will be copied from the template and only the content will be generated by AI.
  - `theme` object
    - `colors` object[]
      - `id` string, required — Needs to follow the pattern: "color_<number>". (color_1, color_2, etc). This property cannot be changed once set.
      - `label` string, required
      - `value` string, required — Color in hex, rgb, or rgba format. Examples: "#FF5733", "rgb(255,87,51)", "rgba(255,87,51,0.8)"
    - `text` object
      - `default` object
        - `breakpoints` object
          - `mobile` object
            - `font_size` string
          - `tablet` object
            - `font_size` string
        - `color` string
        - `font_family` string
        - `font_size` string
        - `font_style` string
        - `font_weight` string
        - `letters_spacing` string
        - `line_height` string
        - `text_decoration` string

## Response `200`

---

[API](https://skmtc.net/duda/apis/partner-api.md) · [All operations](https://skmtc.net/duda/apis/partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/duda/partner-api/revisions/5b9208270ed1/schema)