---
title: "Add Link"
method: POST
path: "/api/cards/{card_id}/links"
tags: ["dashboards"]
---

# Add Link

`POST /api/cards/{card_id}/links`

## Request

- Base URL: `https://app.ctlsurf.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.ctlsurf.com/api/cards/{card_id}/links`
- Auth: HTTP bearer

## Path parameters

- `card_id` string, uuid, required

## Request body

- LinkCreate
  - `relation` 'evidence' | 'related' | 'follow_up' | 'parent' | 'supersedes'
  - `target_kind` 'page' | 'block' | 'task_item' | 'card' | 'commit' | 'url', required
  - `target_id` string, uuid, nullable
  - `target_ref` string, nullable
  - `label` string, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ctlsurf/apis/notebook-control-plane.md) · [All operations](https://skmtc.dev/ctlsurf/apis/notebook-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/ctlsurf/apis/notebook-control-plane/revisions/ddfbbe20d5ce?raw)