---
title: "Get Message Share Link with Shared Message"
method: GET
path: "/message-sharelinks/{share_link_id}"
tags: ["Message Share Links"]
deprecated: true
---

# Get Message Share Link with Shared Message

`GET /message-sharelinks/{share_link_id}`

## Request

- Base URL: `https://api.carbonvoice.app`
- URL: `https://api.carbonvoice.app/message-sharelinks/{share_link_id}`
- Auth: one of:
  - API key in header `pxtoken`
  - OAuth 2 (implicit, authorization URL `https://api.carbonvoice.app/oauth/authorize`)

> **Deprecated.**

## Path parameters

- `share_link_id` string, required

## Response `200`

- MessageShareLinkWithSharedMessage
  - `_id` string, required: Unique Identifier of share link
  - `created_by` string, required: Identifier of the User who created the share/forward
  - `channel_id` string, nullable: Channel ID where forwarded message was sent to
  - `message_id` string, nullable: Message ID that has the share_link_id attached to
  - `created_at` number, required
  - `last_updated_at` number, required
  - `end_access_at` number, nullable: Date when the access to shared message ends
  - `revoked_at` number, nullable
  - `revoked_by` string, nullable
  - `share_type` 'forward' | 'link', required: What is the ShareType of the MessageShareLink
  - `access_type` 'public' | 'specified' | 'forward', required: What is the access type for the MessageShareLink
  - `specified_access` SpecifiedAccess[]: List of Specified Access for the MessageShareLink
    - `type` 'channel' | 'workspace' | 'workspace_group' | 'user', required: What is the Specified access type for the MessageShareLink
    - `ids` string[], required: List of IDs that have access to the MessageShareLink
  - `reply_type` 'shared' | 'private_only', required: How replies to this share link behave. Legacy links without the field are private_only.
  - `reply_conversation_id` string, nullable: Conversation holding the shared replies to this link, if one was already created
  - `shared_message` SharedMessage, required
    - `attachments` Attachment[], required
      - `_id` string, required
      - `client_id` string, nullable
      - `creator_id` string, required
      - `created_at` string, date-time, required
      - `type` 'link' | 'file' | 'location' | 'ai-response-id' | 'ai-prompt-id' | 'action-item-id' | 'ask-id', required
      - `link` string, required
      - `active_begin` string, date-time, nullable
      - `active_end` string, date-time, nullable
      - `filename` string, nullable
      - `mime_type` string, nullable
      - `length_in_bytes` number, nullable
      - `location` LatLon
        - `latitude` number, double, required
        - `longitude` number, double, required
      - `status` 'Initializing' | 'Uploading' | 'Uploaded' | 'Failed'
      - `percent_complete` number, nullable
    - `name` string, nullable
    - `is_text_message` boolean, required
    - `audio_models` AudioModelV2[], required
      - `_id` string, required
      - `url` string, required
      - `extension` string, nullable, required
      - `streaming` boolean, required
      - `language` string, required
      - `duration_ms` number, required
      - `waveform_percentages` number[], required
      - `is_original_audio` boolean, required
    - `text_models` TextModel[], required
      - `type` 'transcript' | 'transcript_with_timecode' | 'summary' | 'topic' | 'bullet_list', required
      - `audio_id` string, nullable, required
      - `language_id` string, required
      - `value` string, required
      - `timecodes` TimedText[], required
        - `t` string, required: The text
        - `s` number, required: The start time in ms
        - `e` number, required: The end time in ms
    - `duration_ms` number, required: The length of the message in milliseconds
    - `creator_id` string, required
    - `original_message_info` OriginalMessageInfo
      - `message_id` string, required: Original message ID
      - `channel_id` string: Original message Channel ID
      - `workspace_id` string, required: Original message Workspace ID
    - `created_at` number, required
    - `last_updated_at` number, required

## Other responses

- `403`

---

[API](https://skmtc.dev/carbonvoice/apis/carbon-voice-api.md) · [All operations](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/revisions/b91c5c845122?raw)