Answer a question

Answers a viewer question. Checks FAQs first (exact then semantic match at >= 0.6 confidence), falls back to GPT-4o with slide context. Returns answer text plus synthesized audio.

Authentication: Accepts either a session cookie (admin) or a presentationId (public viewer).

POST /api/qa

Answer a question

cURL

curl --request POST \
  --url https://app.demand-iq.com/api/qa \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "slideId": "<string>",
  "deckId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "presentationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "history": [
    {
      "role": "user",
      "content": "<string>"
    }
  ],
  "voiceId": "<string>",
  "language": "en"
}
'

200

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

Body

application/json

question · string · required

Minimum string length: 3

slideId · string · required

Current slide ID for context

deckId · string<uuid>

presentationId · string<uuid>

Required for unauthenticated viewer access

history · object[]

Show child attributes

voiceId · string

language · string

BCP-47 language tag

Example:

"en"

Response

200

application/json

Answer with audio

answer · string · required

audioUrl · string · required

Accessible URL for the TTS audio of the answer

source · enum<string> · required

Available options: faq, cached, openai, fallback

wordTimings · object[]

Show child attributes

relatedSlideId · string | null

structured · object

Show child attributes