---
title: "Enable or disable Artifact Twin for an owned Living Link"
method: PUT
path: "/api/decks/{id}/twin"
tags: ["Artifact Twin Owner"]
---

# Enable or disable Artifact Twin for an owned Living Link

`PUT /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`

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `enabled` boolean, required

## Response `200`

Canonical Twin state

- 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

- `400`: Request body or query parameters failed validation
- `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)