---
title: "List every share link you created, newest first"
method: GET
path: "/api/preview/share/links"
tags: ["share"]
---

# List every share link you created, newest first

`GET /api/preview/share/links`

## Request

- Base URL: `https://symbol.chat` (the document declares no server; this is the origin it was published from)
- URL: `https://symbol.chat/api/preview/share/links`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-next-auth.session-token`
  - OAuth 2
    - Authorization code: `https://mcp.symbol.chat/authorize`
    - Token URL: `https://mcp.symbol.chat/token`

## Query parameters

- `cursor` string: `next_cursor` from the previous page. Omit for the first page.
- `limit` integer: Rows per page, 1 to 100. Default 25.
- `state` 'live' | 'all': `live` (default): links that have not expired or run out of views, including any its organization has paused (`state: "suspended"`), so they can still be revoked. `all`: also links that expired or ran out of views. Revoked links are never listed.

## Response `200`

Successful response

- object
  - `links` object[], required
    - `created_at` string, required
    - `expires_at` string, nullable
    - `id` string, required: UUID v4 string
    - `is_active` boolean, required
    - `is_live` boolean, required
    - `listing` boolean, required
    - `max_views` integer, nullable
    - `permission` string, required
    - `primary` boolean, required
    - `resource_id` string, required: UUID v4 string
    - `resource_path` string, nullable
    - `resource_title` string, nullable
    - `resource_type` 'capsule' | 'type' | 'collection' | 'project', required
    - `revoked_at` string, nullable
    - `share_url` string, uri, nullable, required
    - `share_url_unavailable_reason` 'listing' | 'withheld' | 'legacy' | 'unreadable', nullable
    - `state` 'active' | 'expired' | 'exhausted' | 'suspended' | 'revoked', required
    - `token_preview` string, required
    - `view_count` integer, required
  - `next_cursor` string, nullable, required

## Changes

- **2026-10-27** `3a2c4ebeab51`: 1 info
  - added the optional property `links/items/share_url_unavailable_reason` to the response with the `200` status
- **2026-10-09** `c7729725d527`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/symbol/apis/symbol-api/changes/api/preview/share/links/get.md)

---

[API](https://skmtc.dev/symbol/apis/symbol-api.md) - [All operations](https://skmtc.dev/symbol/apis/symbol-api/llms.txt) - [OpenAPI document](https://skmtc.dev/symbol/apis/symbol-api/revisions/3a2c4ebeab51?raw)