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

# Hero and starter prompts for a route



## OpenAPI

````yaml /openapi/v3.yaml get /api/v2/assistant/starter-prompts
openapi: 3.1.0
info:
  title: Semicola Exchange API
  version: 3.0.0-preview
  description: >-
    Platform endpoints of Semicola: sign-in and accounts, members and keys,
    billing, notifications, the Semi assistant (chat stream, confirmations,
    conversations), the MCP App widget host and realtime feeds. Typed agent
    tools live on the MCP server at /mcp/v3.
servers:
  - url: https://api.semicola.com
security:
  - bearerAuth: []
  - sessionCookie: []
tags:
  - name: Auth
  - name: Accounts
  - name: Billing
  - name: Notifications
  - name: Assistant
  - name: Widget host
  - name: Realtime
  - name: Demo
paths:
  /api/v2/assistant/starter-prompts:
    get:
      tags:
        - Assistant
      summary: Hero and starter prompts for a route
      operationId: getAssistantStarterPrompts
      parameters:
        - name: route
          in: query
          required: true
          schema:
            type: string
        - name: language
          in: query
          required: false
          schema:
            type: string
            enum:
              - ar
              - de
              - en
              - es
              - fr
              - hi
              - it
              - ko
              - nl
              - pl
              - pt
              - sv
              - tr
              - ja
              - zh
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    anyOf:
                      - type: object
                        properties:
                          hero:
                            anyOf:
                              - type: object
                                properties:
                                  title:
                                    type: string
                                  subtitle:
                                    type: string
                                required:
                                  - title
                                  - subtitle
                                additionalProperties: false
                              - type: 'null'
                          prompts:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                label:
                                  type: string
                                prompt:
                                  type: string
                                intent:
                                  type: string
                                  enum:
                                    - why_paused
                                    - explain_status
                                    - optimize
                                    - what_changed
                                    - how_to_use
                                    - open_feature
                                    - troubleshoot
                                    - storefront_setup
                                    - third_party_sales_agent_diagnostics
                              required:
                                - id
                                - label
                                - prompt
                              additionalProperties: false
                          chips:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                label:
                                  type: string
                                prompt:
                                  type: string
                                intent:
                                  type: string
                                  enum:
                                    - why_paused
                                    - explain_status
                                    - optimize
                                    - what_changed
                                    - how_to_use
                                    - open_feature
                                    - troubleshoot
                                    - storefront_setup
                                    - third_party_sales_agent_diagnostics
                              required:
                                - id
                                - label
                                - prompt
                              additionalProperties: false
                        required:
                          - hero
                          - prompts
                          - chips
                        additionalProperties: false
                      - type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                          message:
                            type: string
                          field:
                            type: string
                          details: {}
                        required:
                          - code
                          - message
                        additionalProperties: false
                      - type: 'null'
                required:
                  - data
                  - error
                additionalProperties: false
        default:
          description: >-
            Error envelope `{data: null, error: {code, message, field?,
            details?}}`.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or OAuth access token.
    sessionCookie:
      type: apiKey
      in: cookie
      name: sc_session

````