Content Transformation

The Tenovos Transformation endpoints allow you to retrieve content with an applied transformation.

SecurityOAuth2
Request
header Parameters
content-type
string
Example: application/json
Authorization
string
Example: Bearer <token>
Request Body schema: application/json
assetId
string <uuid>

Unique Asset Identifier for the asset you wish to perform a transformation against

convertTo
string

Indicates the requested output file format for the transformation. Content will be converted to this format.

Enum: "JPG" "PNG" "PSD" "TIFF" "WEBP" "BMP" "HEIC" "GIF" "PDF"
width
integer

Indicates the width of the image after transformation. If aspect ratio is fixed and width is null, width will be dynamically sized based on height.

height
integer

Indicated the height of the image after transformation. If aspect ratio is fixed and height is null, height will be dynamically sized based on width.

aspectRatio
string

When native, the native aspect ratio of the original asset will be used.

Enum: "native" "4:3" "3:2" "16:9" "5:3" "5:4" "1:1"
interlaced
boolean
Default: false
Responses
200

Successful Request. Transformation Created Successfully.

400

One or more required parameters are missing or invalid.

401

Authentication failed (unauthorized).

403

Forbidden. You do not have permissions to perform this action, or your connection information is not correct.

422

Invalid data. The convertTo value is not compatible for the asset.

503

The server is too busy to handle the request.

post/transform
Request samples
application/json
{
  • "assetId": "e6f4bd5e-9bea-43cb-b15e-22582fa5322e",
  • "convertTo": "JPG",
  • "width": 2048,
  • "height": 0,
  • "aspectRatio": "native",
  • "interlaced": false
}