---
updatedAt: 2026-07-30T11:03:47.000Z
agentTools:
projectIndex: https://developer.orangelogic.com/llms.txt
---
# Get public link
Get an embed or download link to a single asset
Here is an example call using sample values for each of the query parameters described in the table below.
Example call
```
https://mangovations.com/webapi/objectmanagement/share/getlink_4HZ_v1?Identifier=CTL531031&Format=TR1&StickToCurrentVersion=true&LogViews=true&CreateDownloadLink=true&ExpirationDate=2024-12-31T11%3A59%3A59&MaxWidth=1000&FileExtension=.png
```
This parameter or the Identifier parameter is required.",
"schema": {
"type": "string"
}
},
{
"name": "Identifier",
"in": "query",
"description": "The Unique Identifier of an asset.
This parameter or the RecordID parameter is required.",
"schema": {
"type": "string"
}
},
{
"name": "Format",
"in": "query",
"description": "The code of the asset format that you want to generate a link for (TRX, TR1, etc.).",
"schema": {
"type": "string"
}
},
{
"name": "StickToCurrentVersion",
"in": "query",
"description": "True: The link will point to the current version.False: The link will always point to the most recent version of the asset.",
"schema": {
"type": "boolean"
}
},
{
"name": "LogViews",
"in": "query",
"description": "Whether OrangeDAM logs each view or download. Administrators can view this information in the Full logs of views and downloads. Orange Logic users with a Link account can go to the Full logs of views and downloads article to learn more.",
"schema": {
"type": "boolean"
}
},
{
"name": "CreateDownloadLink",
"in": "query",
"description": "True: The link downloads the assets.False: The link will be an embed link.",
"schema": {
"type": "boolean"
}
},
{
"name": "ExpirationDate",
"in": "query",
"description": "An expiration date in the ISO 8601 format: \"YYYY-MM-DDTHH:MM:SS.SSSZ\" The [sss] value is optional. It represents the UTC offset. Example: \"2024-10-31T13:44:39.735Z\"",
"schema": {
"type": "string"
}
},
{
"name": "MaxWidth",
"in": "query",
"description": "The maximum width of the asset.
If you are generating transformations, the transformation crop or resize takes precedence over MaxWidth.",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "MaxHeight",
"in": "query",
"description": "The maximum height of the asset.
If you are generating transformations, the transformation crop or resize takes precedence over MaxHeight.",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "FileExtension",
"in": "query",
"description": "The file extension of the asset (.jpeg, .png, etc.).",
"schema": {
"type": "string"
}
},
{
"name": "ImageResizingMethod",
"in": "query",
"description": "Resizes the image's aspect ratio based on Maxwidth and MaxHeight.",
"schema": {
"type": "string",
"enum": [
"Fit",
"Stretch",
"NorthwestCrop",
"NorthCrop",
"NortheastCrop",
"WestCrop",
"CenterCrop",
"EastCrop",
"SouthwestCrop",
"SouthCrop",
"SoutheastCrop",
"OpticalCrop",
"AICrop"
]
}
},
{
"name": "Transformations",
"in": "query",
"description": "Enter a string for each transformation you want to apply to the asset. Transformations are applied in the order in which they appear in the string and take precedence over Maxwidth and MaxHeight.
See the transformation example for more information.",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "Title",
"in": "query",
"description": "Title of the asset link",
"schema": {
"type": "string"
}
},
{
"name": "TrackingParameters",
"in": "query",
"description": "{ \"name\": \"string\", \"value\": \"string\" }",
"schema": {
"properties": {
"name": {
"type": "string",
"description": "The UTM name, such as utm_source or utm_campaign."
},
"value": {
"type": "string",
"description": "The UTM value, such as Instagram."
}
},
"type": "object"
}
},
{
"name": "CustomAccessKey",
"in": "query",
"description": "Enter a custom access key to use for the generated link. If this is not specified, the link will have a random access key.",
"schema": {
"type": "string"
}
},
{
"name": "IsVideo",
"in": "query",
"description": "Set to true if the asset is a video.",
"schema": {
"type": "boolean"
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"recordID\": \"2RBKT7UG4BTS\",\n \"identifier\": \"CTL531031\",\n \"format\": \"TR1\",\n \"link\": \"https://mangovations.com/AssetLink/pse8t3wh5q00rj33m441x5k561l817a7.png\",\n \"maxWidth\": 1000,\n \"maxHeight\": null,\n \"expirationDate\": \"2028-12-31T11:59:59\",\n \"fileExtension\": \".png\",\n \"imageResizingMethod\": null\n}"
}
},
"schema": {
"type": "object",
"properties": {
"recordID": {
"type": "string",
"example": "2RBKT7UG4BTS"
},
"identifier": {
"type": "string",
"example": "CTL531031"
},
"format": {
"type": "string",
"example": "TR1"
},
"link": {
"type": "string",
"example": "https://mangovations.com/AssetLink/pse8t3wh5q00rj33m441x5k561l817a7.png"
},
"maxWidth": {
"type": "integer",
"example": 1000,
"default": 0
},
"maxHeight": {},
"expirationDate": {
"type": "string",
"example": "2028-12-31T11:59:59"
},
"fileExtension": {
"type": "string",
"example": ".png"
},
"imageResizingMethod": {}
}
}
}
}
}
},
"deprecated": false,
"x-readme": {
"code-samples": [
{
"language": "text",
"code": "'https://mangovations.com/webapi/objectmanagement/share/getlink_4HZ_v1?Identifier=CTL531031&Format=TR1&StickToCurrentVersion=true&LogViews=true&CreateDownloadLink=true&ExpirationDate=2028-12-31T11%3A59%3A59&MaxWidth=1000&FileExtension=.png' \\\n"
}
],
"samples-languages": [
"text"
]
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```