Shade icon

Shade

Interact with Shade API

Asset → Share

AI-generated

Summary

Generate a public share link for an asset in a specified drive within a workspace, controlling its enabled status and permitted actions.

Inputs

  • Workspace — The workspace context to operate in, selectable from a list or by ID.
  • Drive (required) — The drive ID where the asset resides, selectable from a list or by ID.
  • Path (required) — The full path to the asset to share; if missing the drive prefix, it will be prepended automatically.
  • Name (required) — Name assigned to the share link.
  • Public Enabled (required) — Boolean flag to enable (true) or disable (false) the share link.
  • Allowed Actions (required) — List of permitted actions for the shared asset, such as comment, download, edit metadata, upload, view, and view metadata.

Output shape

a single record representing the newly created share link details

Returns the created share link information from the Shade API. The path provided will be normalized to include the drive prefix if not already included. Requires proper permissions and valid drive and asset path.

Examples

Example 1: Share an asset making it publicly accessible with download and view permissions

Workspace ID: workspace-123 (optional), Drive ID: drive-456, Path: /my-folder/my-picture.jpg, Name: "Public Share Link", Public Enabled: true, Allowed Actions: ["download", "read"]

Links

Discussion