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

# GET /api/links

`GET /api/links`

## Response `default`

- LinksDto
  - `links` object[], required
    - `description` string, nullable, required
    - `iconUrl` union, required
      - string, uri
      - ''
    - `id` number, required
    - `isVisibleOnGuestDashboard` boolean, required
    - `title` string, required
    - `url` string, uri, required
    - `userId` number, required

## Changes

- **2025-09-19** `04aac8a043a6` — 1 breaking
  - removed the success response with the status `200`
- **2025-09-07** `8894b9440760` — 2 breaking, 2 info
  - response property `links/items/description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `links/items/description` response property's maxLength was unset from `50` for the response status `200`
  - added `subschema #1, subschema #2` to the `links/items/iconUrl` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `links/items/iconUrl` response property `oneOf` list for the response status `200`
- **2025-05-09** `0db10235cd0a` — 1 info
  - added the success response with the status `200`

[Change history](https://skmtc.dev/runtipi/apis/runtipi-api/changes/api/links/get.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)