---
title: "Create Link"
method: POST
path: "/api/v1/assistant/gems/{gem_id}/card/links"
tags: ["Piece Record"]
---

# Create Link

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

## 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/links`
- Auth: HTTP bearer

## Path parameters

- `gem_id` integer, required

## Request body

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

## Response `201`

Successful Response

- LinkCreatedOut
  - `id` integer, required
  - `url` string, required
  - `expires_at` string, date-time, required
  - `created_at` string, date-time, required
  - `shows` string, required
  - `card` CardContentOut, required
    - `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)