---
title: "Preview Card"
method: POST
path: "/api/v1/assistant/gems/{gem_id}/card/preview"
tags: ["Piece Record"]
---

# Preview Card

`POST /api/v1/assistant/gems/{gem_id}/card/preview`

## Request

- Base URL: `https://api.gemstoneaiapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gemstoneaiapp.com/api/v1/assistant/gems/{gem_id}/card/preview`
- Auth: HTTP bearer

## Path parameters

- `gem_id` integer, required

## Request body

- CardSelection
  - `facts` string[]
  - `stories` integer[]
  - `people` integer[]
  - `photo` boolean
  - `prices` boolean

## Response `200`

Successful Response

- CardContentOut
  - `title` string, required
  - `subtitle` string, nullable
  - `photo_url` string, nullable
  - `facts` CardFactOut[], required
    - `key` string, required
    - `label` string, required
    - `value` string, required
    - `basis` string, nullable
    - `note` string, nullable
    - `price` boolean
    - `on` boolean
  - `stories` StoryOut[], required
    - `id` integer, required
    - `text` string, required
    - `basis` 'recollection' | 'documented', required
    - `label` string, required
    - `kept_from_chat` boolean
    - `updated_at` string, date-time, nullable
  - `people` PersonOut[], required
    - `id` integer, required
    - `name` string, nullable
    - `role` 'from' | 'for', required
    - `relation` string, nullable
    - `text` string, required
    - `updated_at` string, date-time, nullable
  - `value` object, nullable
  - `note` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api.md) · [All operations](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/revisions/fcb441f55161?raw)