https://manage.kontent.ai/v2/projects/{environment_id}/assets/{asset_identifier}/renditionshttps://manage.kontent.ai/v2/projects/{environment_id}/assets/{asset_identifier}/renditions/{rendition_identifier}https://manage.kontent.ai/v2/projects/{environment_id}/assets/{asset_identifier}/renditionshttps://manage.kontent.ai/v2/projects/{environment_id}/assets/{asset_identifier}/renditions/{rendition_identifier}environment_idasset_identifierx-continuationasset_renditions[]environment_idasset_identifierrendition_identifierrendition_idasset_idexternal_idenvironment_idasset_identifierSpecify how to transform the original asset.
external_idtransformationrendition_idasset_idexternal_idenvironment_idasset_identifierrendition_identifiertransformationmodefitrendition_idasset_idexternal_idpaginationtransformationlast_modifiedtransformationlast_modifiedcustom_widthcustom_heightxywidthheighttransformationlast_modifiedfcbb12e6-66a3-4672-85d9-d502d16b8d9c), codename (e.g., codename/my_asset, or external ID (e.g., external-id/my-own-asset-identifier-42).x-continuation header parameter to the value of the continuation_token property.fcbb12e6-66a3-4672-85d9-d502d16b8d9c), codename (e.g., codename/my_asset, or external ID (e.g., external-id/my-own-asset-identifier-42).ce559491-0fc1-494b-96f3-244bc095de57) or external ID (e.g., external-id/hero-image-rendition).external_id property is not present.fcbb12e6-66a3-4672-85d9-d502d16b8d9c), codename (e.g., codename/my_asset, or external ID (e.g., external-id/my-own-asset-identifier-42).external_id property is not present.x, y, width, and height properties. The custom_width and custom_height properties set the dimensions of the output image.
The x and y coordinates define a point in the original image. The point is specified as the distance from the top-left corner of the original image asset in pixels. The whole area must be within the borders of the original image. Upscaling, that is setting the custom_width and custom_height greater than widthexternal_id property is not present.fcbb12e6-66a3-4672-85d9-d502d16b8d9c), codename (e.g., codename/my_asset, or external ID (e.g., external-id/my-own-asset-identifier-42).ce559491-0fc1-494b-96f3-244bc095de57) or external ID (e.g., external-id/hero-image-rendition).x, y, width, and height properties. The custom_width and custom_height properties set the dimensions of the output image.
The x and y coordinates define a point in the original image. The point is specified as the distance from the top-left corner of the original image asset in pixels. The whole area must be within the borders of the original image. Upscaling, that is setting the custom_width and custom_height greater than widthrect mode is allowed.external_id property is not present.heightheightx, y, width, and height properties. The custom_width and custom_height properties set the dimensions of the output image.
The x and y coordinates define a point in the original image. The point is specified as the distance from the top-left corner of the original image asset in pixels. The whole area must be within the borders of the original image. Upscaling, that is setting the custom_width and custom_height greater than widthx, y, width, and height properties. The custom_width and custom_height properties set the dimensions of the output image.
The x and y coordinates define a point in the original image. The point is specified as the distance from the top-left corner of the original image asset in pixels. The whole area must be within the borders of the original image. Upscaling, that is setting the custom_width and custom_height greater than widthwidth.Use custom_width if you want to resize the rectangle region selected via x, y, width, and height. That is to keep the contents of the selected rectangle region but make the output image smaller.height.Use custom_height if you want to resize the rectangle region selected via x, y, width, and height. That is to keep the contents of the selected rectangle region but make the output image smaller.y property, the coordinates specify the top-left corner of the source rectangle region defined by width and height.The x's maximum value depends on the width parameter. The whole rectangle must fit within the borders of the original image.x property, the coordinates specify the top-left corner of the source rectangle region defined by width and height.The y's maximum value depends on the height parameter. The whole rectangle must fit within the borders of the original image.x and y, specifies the width of the rectangle area.x and y, specifies the height of the rectangle area.x, y, width, and height properties. The custom_width and custom_height properties set the dimensions of the output image.
The x and y coordinates define a point in the original image. The point is specified as the distance from the top-left corner of the original image asset in pixels. The whole area must be within the borders of the original image. Upscaling, that is setting the custom_width and custom_height greater than widthheightheightheightrendition_idasset_idexternal_idtransformationlast_modifiedexternal_id property is not present.x, y, width, and height properties. The custom_width and custom_height properties set the dimensions of the output image.
The x and y coordinates define a point in the original image. The point is specified as the distance from the top-left corner of the original image asset in pixels. The whole area must be within the borders of the original image. Upscaling, that is setting the custom_width and custom_height greater than widthheight{
"rendition_id": "d866c136-8824-45f9-af39-9ebf9c31ea8f",
"asset_id": "ba00e3ba-e217-4fc0-9f4e-90b9510d2b08",
"external_id": "rendition-external-id-01",
"transformation": {
"mode": "rect",
"fit": "clip",
"custom_width": 250,
"custom_height": 50,
"x": 0,
"y": 30,
"width": 500,
"height": 100
},
"last_modified": "2022-03-01T10:54:52.1001012Z"
}{
"asset_renditions": {
"rendition_id": "d866c136-8824-45f9-af39-9ebf9c31ea8f",
"asset_id": "ba00e3ba-e217-4fc0-9f4e-90b9510d2b08",
"external_id": "rendition-external-id-01",
"transformation": {
"mode": "rect",
"fit": "clip",
"custom_width": 250,
"custom_height": 50,
"x": 0,
"y": 30,
"width": 500,
"height": 100
},
"last_modified": "2022-03-01T10:54:52.1001012Z"
},
"pagination": {
"continuation_token": "W3sidG9rZW4iOiIrUklEOn...",
"next_page": "https://manage.kontent.ai/v2/your/chosen/list/endpoint"
}
}{
"rendition_id": "d866c136-8824-45f9-af39-9ebf9c31ea8f",
"asset_id": "ba00e3ba-e217-4fc0-9f4e-90b9510d2b08",
"external_id": "rendition-external-id-01",
"transformation": {
"mode": "rect",
"fit": "clip",
"custom_width": 250,
"custom_height": 50,
"x": 0,
"y": 30,
"width": 500,
"height": 100
},
"last_modified": "2022-03-01T10:54:52.1001012Z"
}{
"rendition_id": "d866c136-8824-45f9-af39-9ebf9c31ea8f",
"asset_id": "ba00e3ba-e217-4fc0-9f4e-90b9510d2b08",
"external_id": "rendition-external-id-01",
"transformation": {
"mode": "rect",
"fit": "clip",
"custom_width": 250,
"custom_height": 50,
"x": 0,
"y": 30,
"width": 500,
"height": 100
},
"last_modified": "2022-03-01T10:54:52.1001012Z"
}{
"rendition_id": "d866c136-8824-45f9-af39-9ebf9c31ea8f",
"asset_id": "ba00e3ba-e217-4fc0-9f4e-90b9510d2b08",
"external_id": "rendition-external-id-01",
"transformation": {
"mode": "rect",
"fit": "clip",
"custom_width": 250,
"custom_height": 50,
"x": 0,
"y": 30,
"width": 500,
"height": 100
},
"last_modified": "2022-03-01T10:54:52.1001012Z"
}// Tip: Find more about JS/TS SDKs at https://kontent.ai/learn/javascript
import { ManagementClient } from '@kontent-ai/management-sdk';
const client = new ManagementClient({
environmentId: 'KONTENT_AI_ENVIRONMENT_ID',
apiKey: 'KONTENT_AI_MANAGEMENT_API_KEY',
});
// Gets the first page of results
const response = await client
.listAssetRenditions()
.byAssetId('fcbb12e6-66a3-4672-85d9-d502d16b8d9c')
// .byAssetExternalId('which-brewing-fits-you')
.toPromise();
// Tip: Find more about JS/TS SDKs at https://kontent.ai/learn/javascript
import { ManagementClient } from '@kontent-ai/management-sdk';
const client = new ManagementClient({
environmentId: 'KONTENT_AI_ENVIRONMENT_ID',
apiKey: 'KONTENT_AI_MANAGEMENT_API_KEY',
});
const response = await client
.viewAssetRendition()
.byAssetId('fcbb12e6-66a3-4672-85d9-d502d16b8d9c')
// .byAssetExternalId('which-brewing-fits-you')
.byRenditionId('ce559491-0fc1-494b-96f3-244bc095de57')
// .byRenditionExternalId('hero-image-rendition')
.toPromise();
// Tip: Find more about JS/TS SDKs at https://kontent.ai/learn/javascript
import { ManagementClient } from '@kontent-ai/management-sdk';
const client = new ManagementClient({
environmentId: 'KONTENT_AI_ENVIRONMENT_ID',
apiKey: 'KONTENT_AI_MANAGEMENT_API_KEY',
});
const response = await client
.addAssetRendition()
.byAssetId('fcbb12e6-66a3-4672-85d9-d502d16b8d9c')
// .byAssetExternalId('which-brewing-fits-you')
.withData({
external_id: 'hero-image-rendition',
transformation: {
fit: 'clip',
mode: 'rect',
height: 120,
width: 240,
x: 300,
y: 200,
custom_height: 360,
custom_width: 720,
},
})
.toPromise();
// Tip: Find more about JS/TS SDKs at https://kontent.ai/learn/javascript
import { ManagementClient } from '@kontent-ai/management-sdk';
const client = new ManagementClient({
environmentId: 'KONTENT_AI_ENVIRONMENT_ID',
apiKey: 'KONTENT_AI_MANAGEMENT_API_KEY',
});
const response = await client
.modifyAssetRendition()
.byAssetId('fcbb12e6-66a3-4672-85d9-d502d16b8d9c')
// .byAssetExternalId('which-brewing-fits-you')
.byRenditionId('ce559491-0fc1-494b-96f3-244bc095de57')
// .byRenditionExternalId('hero-image-rendition')
.withData({
transformation: {
fit: 'clip',
mode: 'rect',
height: 120,
width: 240,
x: 300,
y: 200,
custom_height: 360,
custom_width: 720,
},
})
.toPromise();