Ask a question

Submit a question during a presentation. Routes through FAQ matching (exact, then semantic) and falls back to AI generation. Supports both authenticated admin and public access.

POST /api/qa

Ask a question

cURL

curl --request POST \
  --url https://app.demandiq.com/api/qa \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "How long does solar panel installation take?",
  "slideId": "<string>",
  "history": [
    {
      "role": "user",
      "content": "<string>"
    }
  ],
  "voiceId": "<string>",
  "deckId": "<string>",
  "presentationId": "<string>",
  "language": "en"
}
'

200

{
  "answer": "<string>",
  "audioUrl": "<string>",
  "wordTimings": [
    {
      "word": "<string>",
      "startTime": 123,
      "endTime": 123
    }
  ],
  "source": "faq",
  "relatedSlideId": "<string>"
}

Body

application/json

question · string · required

Minimum string length: 3

Example:

"How long does solar panel installation take?"

slideId · string · required

history · object[]

Show child attributes

voiceId · string

deckId · string

Required for authenticated admin access

presentationId · string

Required for public access

language · string

Example:

"en"

Response

200

application/json

Answer

answer · string

audioUrl · string

wordTimings · object[]

Show child attributes

source · enum<string>

Available options: faq, cached, openai, fallback

relatedSlideId · string