---
title: "Submit one version-bound explicit decision response"
method: POST
path: "/api/d/{id}/decision-responses"
tags: ["Living Link Reader"]
---

# Submit one version-bound explicit decision response

`POST /api/d/{id}/decision-responses`

## Request

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

Email verification, when required, must already be complete. Verification never submits
a response; the Reader presents a separate final confirmation. The same viewer cannot
replace a response for the same deck and configuration version. A first submission without
a viewer cookie requires a UUID v4 Idempotency-Key so a lost response can be retried without
creating another viewer or decision.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string, uuid

## Request body

- LivingDecisionInput
  - `deck_version` integer, required
  - `config_version` integer, required
  - `outcome` 'proceed' | 'needs_changes' | 'not_now' | 'decline', required
  - `note` string: Required when outcome is `needs_changes`; optional otherwise.

## Response `201`

Response recorded and viewer cookie established when needed

- LivingDecisionSuccess
  - `ok` unknown, required
  - `data` object, required
    - `response` LivingDecisionResponse, required
      - `id` string, uuid, required
      - `deck_version` integer, required
      - `config_version` integer, required
      - `outcome` 'proceed' | 'needs_changes' | 'not_now' | 'decline', required
      - `note` string, nullable
      - `status` 'submitted' | 'acknowledged' | 'resolved', required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required

## Other responses

- `400`: Request body or query parameters failed validation
- `404`: Living Link is unavailable under the current rollout, deck, or reader policy

---

[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)