---
title: "POST /api/links"
method: POST
path: "/api/links"
tags: ["Links"]
---

# POST /api/links

`POST /api/links`

## Request body

- LinkBodyDto
  - `title` string, required
  - `url` string, uri, required
  - `description` string
  - `iconUrl` union
    - string, uri
    - ''
  - `isVisibleOnGuestDashboard` boolean

## Response `201`

## Changes

- **2025-11-02** `cfec28cc6df5` — 1 info
  - the `isVisibleOnGuestDashboard` request property default value `false` was removed
- **2025-09-21** `9bb6907a2baf` — 1 info
  - added `subschema #2` to the `iconUrl` request property `anyOf` list
- **2025-09-19** `04aac8a043a6` — 1 breaking
  - removed `subschema #2` from the `iconUrl` request property `anyOf` list
- **2025-09-07** `8894b9440760` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2` from the `iconUrl` request property `oneOf` list
  - added `subschema #1, subschema #2` to the `iconUrl` request property `anyOf` list
- **2025-05-09** `0db10235cd0a` — 1 breaking, 2 info
  - removed `subschema #1, subschema #2` from the `iconUrl` request property `anyOf` list
  - the `isVisibleOnGuestDashboard` request property default value `false` was added
  - added `subschema #1, subschema #2` to the `iconUrl` request property `oneOf` list

[Change history](https://skmtc.dev/runtipi/apis/runtipi-api/changes/api/links/post.md)

---

[API](https://skmtc.dev/runtipi/apis/runtipi-api.md) · [All operations](https://skmtc.dev/runtipi/apis/runtipi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runtipi/runtipi-api/revisions/5c7deb969194/schema)