---
title: "Read Artifact Twin configuration and current-version Passport status"
method: GET
path: "/api/decks/{id}/twin"
tags: ["Artifact Twin Owner"]
---

# Read Artifact Twin configuration and current-version Passport status

`GET /api/decks/{id}/twin`

## Request

- Base URL: `https://slidesfly.com`
- URL: `https://slidesfly.com/api/decks/{id}/twin`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sb-access-token`

Owner-only. Artifact Twin stays unavailable until Living Link is enabled and the rollout
permits the owner. No Passport text or excerpts are returned.

## Path parameters

- `id` string, required

## Response `200`

Owner-safe Twin state for the current version

- ArtifactTwinOwnerSuccess
  - `ok` unknown, required
  - `data` ArtifactTwinOwnerState, required
    - `enabled` boolean, required
    - `deck_version` integer, nullable, required
    - `passport_status` 'needs_preparation' | 'preparing' | 'ready' | 'unsupported' | 'failed', required
    - `message` string: Fixed status text only; no source HTML, question, or excerpt.

## Other responses

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