---
title: "Generate a public Share link"
method: POST
path: "/createsharelink_41M9_V1"
---

# Generate a public Share link

`POST /createsharelink_41M9_V1`

Generate a link to share one or more assets

## Request body

- object
  - `title` string — The name of the share. For example, “Spring collection photoshoot.”
  - `description` string — A description of the share. For example, “Photos and video for review.”
  - `assetIDs` string[], required — The unique <a href="https://developer.orangelogic.com/reference/assets#record-id">IDs</a> of the assets included in the share.
  - `expirationDate` string, required — The expiration date of the share, entered as a <a href="https://developer.orangelogic.com/reference/date-and-time">yyyy-mm-ddThh:mm:ss string</a>.
  - `imageFormat` string — The <a href="https://developer.orangelogic.com/reference/assets#formats">format</a> used for all image assets included in the share. You can specify only one image format for a share.
  - `audioFormat` string — The <a href="https://developer.orangelogic.com/reference/assets#formats">format</a> used for all audio assets included in the share. You can specify only one audio format for a share.
  - `videoFormat` string — The <a href="https://developer.orangelogic.com/reference/assets#formats">format</a> used for all video assets included in the share. You can specify only one video format for a share.
  - `containerFormat` 'Small' | 'Medium' | 'Large' | 'Original' — The <a href="https://developer.orangelogic.com/reference/generate-public-share-links">view permissions</a> granted to the link recipient for all containers included in the share. Recipients must have at least View Small permission to see assets. When you choose a format other than small, recipients can access all proxy formats at the level you select and smaller.
  - `watermarkPreset` string — The <a href="https://developer.orangelogic.com/reference/retrieve-watermark-presets-to-use-in-a-public-share-link">watermark</a> applied to all assets included in the share. When this parameter is blank, no watermark is applied.
  - `includeNonWatermarkableAssets` boolean — When <code>true</code>, assets that cannot be watermarked (such as folders) are included in the share.
  - `allowDownload` boolean — When <code>true</code>, recipients can download the shared assets. This permission is granted even if the recipient wouldn’t otherwise be able to download the asset.
  - `allowFind` boolean — When <code>true</code>, recipients with Orange Logic accounts can see the shared assets in the search results. This permission is granted even if the recipient wouldn’t otherwise be able to find the asset.
  - `allowEdit` boolean — When <code>true</code>, recipients can edit the shared assets’ metadata. This permission is granted even if the recipient wouldn’t otherwise be able to edit the asset.
  - `disableMetadataLink` boolean — <ul><li>When <code>true</code>, no links are included in asset metadata.</li><li>When <code>false</code>, asset metadata that is configured to be displayed as clickable links is included with active links. For example, if asset tags are shown as links, users with Orange Logic accounts can click a tag to see all the assets that share that tag.</li></ul>

## Response `200`

200

- object
  - `status` string
  - `shareLink` unknown
  - `accessKey` string
  - `message` string
  - `errors` unknown

---

[API](https://skmtc.net/orangelogic/apis/security.md) · [All operations](https://skmtc.net/orangelogic/apis/security/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orangelogic/security/versions/c8e945426c5e/schema)