---
updatedAt: 2026-07-30T11:03:53.000Z
agentTools:
projectIndex: https://developer.orangelogic.com/llms.txt
---
# Create crop link
Create a link to a cropped version of an asset
To generate a link to a cropped version of an asset, enter a ratio for each coordinate: top Y, bottom Y, left X, and right X.
[block:image]
{
"images": [
{
"image": [
"https://files.readme.io/9915271131b067369e80a5e270e330a8fc4e7a9fec253520e136cda55d211141-Image_with_crop_coordinates_on_the_X_and_Y_scale.png",
"",
"Image with crop coordinates on the X and Y scale"
],
"align": "center",
"sizing": "600px",
"border": true,
"caption": "Image with crop coordinates on the X and Y scale"
}
]
}
[/block]
Here is an example call using sample values for each of the query parameters described in the table below.
Example call
```
https://mangovations.com/api/AssetLink/v1.0/CreateCropLink?Identifier=ZZ13OCT&LogAccess=true&CreateDownloadLink=true&TopY=0.8&LeftX=0.8&BottomY=0.8&RightX=0.8&Height=600&Width=800&ApplyWatermark=false&format=XML
```
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "create-crop-link",
"version": "1.0"
},
"servers": [
{
"url": "https://{OrangeLogicURL}/api/AssetLink",
"variables": {
"OrangeLogicURL": {
"default": "OrangeLogicURL"
}
}
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "oauth2",
"flows": {
"clientCredentials": {
"tokenUrl": "https://example.com/oauth2/token",
"scopes": {}
}
}
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/v1.0/CreateCropLink": {
"get": {
"summary": "Create crop link",
"description": "Create a link to a cropped version of an asset",
"operationId": "create-crop-link",
"parameters": [
{
"name": "Identifier",
"in": "query",
"description": "The asset's unique identifier.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "LogAccess",
"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.",
"required": true,
"schema": {
"type": "boolean"
}
},
{
"name": "CreateDownloadLink",
"in": "query",
"description": "True: The link downloads the assets. False: The link will be an embed link.",
"required": true,
"schema": {
"type": "boolean"
}
},
{
"name": "TopY",
"in": "query",
"description": "Enter a value between 0 and 1 to reflect the ratio of the top Y coordinate of the crop to the height of the original image. Include a “0” before the decimal. Example: 0.8",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "LeftX",
"in": "query",
"description": "Enter a value between 0 and 1 to reflect the ratio of the left X coordinate of the crop to the width of the original image. Include a “0” before the decimal. Example: 0.8",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "BottomY",
"in": "query",
"description": "Enter a value between 0 and 1 to reflect the ratio of the bottom Y coordinate of the crop to the height of the original image. Include a “0” before the decimal. Example: 0.8",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "RightX",
"in": "query",
"description": "Enter a value between 0 and 1 to reflect the ratio of the right X coordinate of the crop to the width of the original image. Include a “0” before the decimal. Example: 0.8",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Height",
"in": "query",
"description": "The height in pixels of the cropped image.",
"required": true,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "Width",
"in": "query",
"description": "The width in pixels of the cropped image.",
"required": true,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "ApplyWatermark",
"in": "query",
"description": "Whether a watermark is applied to the bottom-right corner of the cropped image.",
"required": true,
"schema": {
"type": "boolean"
}
},
{
"name": "ExpirationDate",
"in": "query",
"description": "An expiration date in the format yyyy-MM-ddTHH:mm:ss",
"schema": {
"type": "string"
}
},
{
"name": "format",
"in": "query",
"description": "The response format (XML or JSON)",
"required": true,
"schema": {
"type": "string",
"default": "XML"
}
},
{
"name": "dateformat",
"in": "query",
"description": "Specify the output date format.",
"schema": {
"type": "string",
"default": "yyyy-MM-ddTHH:mm:ss"
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "\n \n LONDON.R2.2131E.216729\n OLU-T-USW2-APP\n 44ddde3ac27a33c394335f249d4007d4\n AssetLink\n v1.0\n CreateCropLink\n True\n \n ZZ13OCT\n true\n true\n 0.8\n 0.8\n 0.8\n 0.8\n 600\n 800\n false\n \n LoggedIn\n \n No session (production configuration)\n 20\n \n \n \n \n \n ZZ13OCT\n False\n 1\n \n \n true\n False\n 1\n \n \n true\n False\n 1\n \n \n 0.8\n False\n 1\n \n \n 0.8\n False\n 1\n \n \n 0.8\n False\n 1\n \n \n 0.8\n False\n 1\n \n \n 600\n False\n 1\n \n \n 800\n False\n 1\n \n \n false\n False\n 1\n \n \n \n True\n 0\n \n \n \n \n https://mangovations.com/AssetLink/ujmehwcy74phmd3g3mtg4k3574mvvr8x.jpg\n \n Executed\n 201\n SUCCESS\n \n"
}
}
}
}
}
},
"deprecated": false,
"x-readme": {
"code-samples": [
{
"language": "text",
"code": "'https://mangovations.com/api/AssetLink/v1.0/CreateCropLink?Identifier=ZZ13OCT&LogAccess=true&CreateDownloadLink=true&TopY=0.8&LeftX=0.8&BottomY=0.8&RightX=0.8&Height=600&Width=800&ApplyWatermark=false&format=XML' \\"
}
],
"samples-languages": [
"text"
]
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```