---
title: "List a workspace's shareable analytics links"
method: GET
path: "/api/v1/workspaces/{workspace_id}/analytics/share-links"
tags: ["🔗 Analytics Share Links"]
---

# List a workspace's shareable analytics links

`GET /api/v1/workspaces/{workspace_id}/analytics/share-links`

## Request

- Base URL: `https://api.contentstudio.io`
- URL: `https://api.contentstudio.io/api/v1/workspaces/{workspace_id}/analytics/share-links`
- Auth: API key in header `X-API-Key`

## Path parameters

- `workspace_id` string, required

## Response `200`

Links retrieved. `password` is never included, whether or not a link has one.

- object
  - `status` boolean
  - `share_links` object[]
    - `id` string
    - `link_id` string
    - `share_url` string
    - `title` string
    - `platform` string
    - `account_id` string, nullable
    - `is_password_protected` boolean
    - `is_disabled` boolean
    - `is_date_range_fixed` boolean
    - `is_account_switching_enabled` boolean: When true the viewer may switch accounts within the workspace, so the link is not confined to account_id.

## Other responses

- `401`: Unauthorized
- `403`: Workspace access refusals return `error_code` `WORKSPACE_ACCESS_DENIED`, `WORKSPACE_INVITATION_PENDING`, `WORKSPACE_LOCKED`, `PERMISSION_DENIED`.

## Changes

- **2026-11-03** `2ce09d50369c`: 1 info
  - added the non-success response with the status `403`
- **2026-09-29** `9c2efef77ec1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1/changes/api/v1/workspaces/:workspace_id/analytics/share-links/get.md)

---

[API](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1.md) - [All operations](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1/revisions/2ce09d50369c?raw)