---
title: "Parse Intent Endpoint"
method: POST
path: "/api/v1/wizard/parse-intent"
tags: ["Wizard"]
---

# Parse Intent Endpoint

`POST /api/v1/wizard/parse-intent`

Parse a free-form business description into a WizardConfig.

The wizard sends the user's text from the Smart-Start landing
screen here and uses the result to pre-fill every downstream step.
Falls back to a 422 if the LLM response can't be parsed against
the schema — the frontend then routes the user to the manual
template-picker path.

## Request body

- ParseIntentRequest
  - `description` string, required

## Response `200`

Successful Response

- IPostResponseBaseWizardConfig
  - `message` string, nullable
  - `meta` union
    - object
    - unknown
  - `data` WizardConfig — The complete config the wizard renders. Returned by the LLM parser AND used as the on-disk shape of starter templates.
    - `channel` 'chat' | 'voice', required
    - `business_summary` string, required
    - `industry_tag` string, required
    - `goal` WizardGoal, required
      - `primary` string, required
      - `summary` string, required
    - `fields` WizardField[]
      - `key` string, required
      - `label` string, required
      - `type` 'text' | 'textarea' | 'number' | 'select' | 'multiselect' | 'phone' | 'url', required
      - `options` string[], nullable
      - `value` unknown
      - `source` 'parsed' | 'default' | 'missing'
      - `required` boolean
      - `placeholder` string, nullable
      - `help_text` string, nullable
      - `can_skip` boolean
      - `skip_fallback` string, nullable
    - `recommended_tools` RecommendedTool[]
      - `tool_key` string, required
      - `reason` string, required
    - `recommended_contact_syncs` RecommendedContactSync[]
      - `tool_key` string, required
      - `fields_to_be_synced` object, required
      - `reason` string, required
    - `recommended_conversation_syncs` RecommendedConversationSync[]
      - `tool_key` string, required
      - `reason` string, required
    - `recommended_outcomes` RecommendedOutcome[]
      - `key` string, required
      - `label` string, required
      - `default_on` boolean
      - `mechanism` 'tool' | 'contact_sync' | 'conversation_sync' | 'summary_email' | 'webhook', required
      - `tool_key` string, nullable
    - `voice_defaults` VoiceDefaults
      - `first_sentence` string, nullable
      - `speaks_first` 'bot' | 'user'
      - `detect_voicemail` 'hangup' | 'drop', nullable
      - `voicemail_message` string, nullable
      - `max_call_duration` integer
      - `use_turn_detector` boolean
      - `listen_silence` number
      - `listen_silence_message` string, nullable
    - `behavior_defaults` BehaviorDefaults
      - `llm_temperature` number
      - `has_human_agent` boolean
      - `use_tools` boolean
      - `summarize` SummarizeConfig
        - `is_active` boolean
        - `email` string, nullable
    - `prompt_skeleton` string, required
    - `confidence` number
    - `missing_critical_fields` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/insighto/apis/ragify.md) · [All operations](https://skmtc.net/insighto/apis/ragify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/insighto/ragify/revisions/cdca56191be9/schema)