---
title: "Ask the exact displayed version for relevant original evidence"
method: POST
path: "/api/d/{id}/twin/questions"
tags: ["Artifact Twin Reader"]
---

# Ask the exact displayed version for relevant original evidence

`POST /api/d/{id}/twin/questions`

## Request

- Base URL: `https://slidesfly.com`
- URL: `https://slidesfly.com/api/d/{id}/twin/questions`
- Auth: one of:
  - HTTP bearer
  - none

The answer is either one to three version-bound excerpts rendered with a fixed template,
or one existing Living Link handoff. There is no generated answer or pending state.
Email verification, when required by Living Link, is a separate completed step before this
request; before verification this route writes no Twin content, evidence, thread, message,
notification, or content analytics event.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string, uuid

## Request body

- ArtifactTwinQuestionInput
  - `deck_version` integer, required: Exact version displayed by the Reader.
  - `body` string, required: Plain-text question. It is never included in analytics, email, or the deck iframe.

## Response `201`

Deterministic evidence result or private owner handoff

- ArtifactTwinQuestionSuccess
  - `ok` unknown, required
  - `data` ArtifactTwinQuestionResult, required
    - `outcome` 'answered' | 'handoff', required
    - `question` ArtifactTwinQuestion, required
      - `id` string, uuid, required
      - `deck_version` integer, required
    - `evidence` ArtifactTwinEvidence[], required
      - `id` string, uuid, required
      - `excerpt` string, required: Verified exact plain-text substring from the current version Passport chunk.
      - `locator` ArtifactTwinLocator, required
        - `slide` integer, nullable
        - `section` string, nullable
    - `thread` ArtifactTwinHandoffThread, required
      - `id` string, uuid, required

## Other responses

- `400`: Request body or query parameters failed validation
- `404`: Living Link is unavailable under the current rollout, deck, or reader policy
- `409`: Idempotency-Key reused with a different body (or still in flight)

---

[API](https://skmtc.dev/slidesfly/apis/slidesfly-http-api.md) · [All operations](https://skmtc.dev/slidesfly/apis/slidesfly-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slidesfly/apis/slidesfly-http-api/revisions/9da38f802ead?raw)