Carbon Voice icon

Carbon Voice

Send messages, voice memos, and manage Carbon Voice resources

Actions10

Message → Create Share Link

AI-generated

Summary

Create a shareable link for a specified message with customizable access restrictions and optional expiration.

Inputs

  • Message ID (required) — ID of the message to share.
  • Access Type (required) — Defines who can access the share link: either anyone with the link (public) or limited to specified users, workspaces, or conversations.
  • Expires At — Optional ISO 8601 datetime string specifying when the share link will expire.
  • Allowed Conversation Names or IDs — If Access Type is 'Specified', a list of conversation names or IDs that are allowed to access the share link.
  • Allowed Workspace Names or IDs — If Access Type is 'Specified', a list of workspace names or IDs granted access to the share link.
  • Allowed User Names or IDs — If Access Type is 'Specified', a list of user names or IDs granted access to the share link.

Output shape

a single JSON object representing the created share link details

Returns the API response containing details of the created share link. When Access Type is 'Specified', at least one allowed conversation, workspace, or user must be provided; otherwise, an error is thrown.

Links

Discussion