---
title: "Ask a question, request clarification, or request a next step"
method: POST
path: "/api/d/{id}/interactions"
tags: ["Living Link Reader"]
---

# Ask a question, request clarification, or request a next step

`POST /api/d/{id}/interactions`

## Request

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

Sets a 90-day deck-scoped HttpOnly viewer cookie on first success.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string, uuid

## Request body

- LivingInteractionInput
  - `deck_version` integer, required: Exact version displayed by the Reader when the interaction is created.
  - `kind` 'question' | 'clarification' | 'next_step', required
  - `category` 'data' | 'scope' | 'price' | 'risk' | 'implementation' | 'other', required
  - `body` string, required: Plain text; at most three HTTP(S) links.
  - `email` string, email

## Response `201`

Conversation created

- LivingCreateSuccess
  - `ok` unknown, required
  - `data` object, required
    - `thread` LivingThread, required
      - `id` string, uuid, required
      - `deck_version` integer, required
      - `kind` 'question' | 'clarification' | 'next_step', required
      - `category` 'data' | 'scope' | 'price' | 'risk' | 'implementation' | 'other', required
      - `status` 'open' | 'replied' | 'viewed' | 'resolved' | 'closed', required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `messages` LivingMessage[]
        - `id` string, uuid, required
        - `author_kind` 'viewer' | 'owner', required
        - `body` string, required
        - `created_at` string, date-time, required
    - `delivery` object, 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)