Image Transformations

Manage transformations for image resource

get

Path parameters

idinteger · int64Required

image id

transformationIdinteger · int64Required

transformation id

Responses

200

OK

application/json

get

/dms/resources/{id}/transformations/{transformationId}

HTTPcURLJavaScriptPython

GET /api/dms/resources/{id}/transformations/{transformationId} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:02:48.233Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:02:48.233Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "uiKey": "text",
  "share": {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:02:48.233Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:02:48.233Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "publicUrlPath": "text",
    "publicUrlCreatedAt": "2026-02-10",
    "publicUrlDurationInMinutes": 1,
    "availability": "UNLIMITED",
    "timesUsed": 1,
    "appId": "123e4567-e89b-12d3-a456-426614174000",
    "sharedByExternalRef": "text",
    "revision": 1,
    "eTag": "text",
    "custom": {},
    "publishState": "SYNCED",
    "translatableTexts": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:02:48.233Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:02:48.233Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "alternativeText": "text",
        "metaTitle": "text",
        "languageCode": "text"
      }
    ],
    "etag": "text"
  },
  "sizeX": 1,
  "sizeY": 1,
  "rotation": 1,
  "watermarkLabel": "text",
  "imageFileStorageHandle": "text",
  "imageFileCreatedAt": "2026-02-10",
  "imageFileDuration": 1
}

Update existing Image Transformation

put

Path parameters

idinteger · int64Required

image id

transformationIdinteger · int64Required

transformationId

Body

application/json

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

uiKeystringOptional

zur Unterscheidung verschiedener Transformationen

sizeXinteger · int32Optional

Breite in pixeln

sizeYinteger · int32Optional

Höhe in pixeln

rotationinteger · int32Optional

Rotation in Grad

watermarkLabelstringOptional

Ein Wasserzeichen

imageFileStorageHandlestringRead-onlyOptional

interne referenz auf die physikalische datei

imageFileCreatedAtstring · dateRead-onlyOptional

wann wurde die physikalische datei erstellt

imageFileDurationinteger · int32Optional

wie viele Tage bleibt diese physikalische datei erhalten (0 = unlimited)

Responses

200

successful operation

application/json

422

Resource was not valid to process

application/json

put

/dms/resources/{id}/transformations/{transformationId}

HTTPcURLJavaScriptPython

PUT /api/dms/resources/{id}/transformations/{transformationId} HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 496

{
  "version": "text",
  "info": {},
  "id": "text",
  "uiKey": "text",
  "share": {
    "version": "text",
    "info": {},
    "id": "text",
    "publicUrlDurationInMinutes": 1,
    "availability": "UNLIMITED",
    "appId": "123e4567-e89b-12d3-a456-426614174000",
    "sharedByExternalRef": "text",
    "custom": {},
    "publishState": "SYNCED",
    "translatableTexts": [
      {
        "version": "text",
        "info": {},
        "id": "text",
        "alternativeText": "text",
        "metaTitle": "text",
        "languageCode": "text"
      }
    ],
    "etag": "text"
  },
  "sizeX": 1,
  "sizeY": 1,
  "rotation": 1,
  "watermarkLabel": "text",
  "imageFileDuration": 1
}

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:02:48.233Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:02:48.233Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "uiKey": "text",
  "share": {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:02:48.233Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:02:48.233Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "publicUrlPath": "text",
    "publicUrlCreatedAt": "2026-02-10",
    "publicUrlDurationInMinutes": 1,
    "availability": "UNLIMITED",
    "timesUsed": 1,
    "appId": "123e4567-e89b-12d3-a456-426614174000",
    "sharedByExternalRef": "text",
    "revision": 1,
    "eTag": "text",
    "custom": {},
    "publishState": "SYNCED",
    "translatableTexts": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:02:48.233Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:02:48.233Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "alternativeText": "text",
        "metaTitle": "text",
        "languageCode": "text"
      }
    ],
    "etag": "text"
  },
  "sizeX": 1,
  "sizeY": 1,
  "rotation": 1,
  "watermarkLabel": "text",
  "imageFileStorageHandle": "text",
  "imageFileCreatedAt": "2026-02-10",
  "imageFileDuration": 1
}

delete an existing image share

delete

Path parameters

idinteger · int64Required

image id

transformationIdinteger · int64Required

an identifier

Responses

200

OK

application/json

delete

/dms/resources/{id}/transformations/{transformationId}

HTTPcURLJavaScriptPython

DELETE /api/dms/resources/{id}/transformations/{transformationId} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}

get

Path parameters

idinteger · int64Required

image id

Responses

200

OK

application/json

get

/dms/resources/{id}/transformations

HTTPcURLJavaScriptPython

GET /api/dms/resources/{id}/transformations HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

[
  {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:02:48.233Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:02:48.233Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "uiKey": "text",
    "share": {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:02:48.233Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:02:48.233Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "publicUrlPath": "text",
      "publicUrlCreatedAt": "2026-02-10",
      "publicUrlDurationInMinutes": 1,
      "availability": "UNLIMITED",
      "timesUsed": 1,
      "appId": "123e4567-e89b-12d3-a456-426614174000",
      "sharedByExternalRef": "text",
      "revision": 1,
      "eTag": "text",
      "custom": {},
      "publishState": "SYNCED",
      "translatableTexts": [
        {
          "version": "text",
          "info": {
            "createdAt": "2026-02-10T16:02:48.233Z",
            "createdFrom": "text",
            "updatedAt": "2026-02-10T16:02:48.233Z",
            "updatedFrom": "text"
          },
          "id": "text",
          "alternativeText": "text",
          "metaTitle": "text",
          "languageCode": "text"
        }
      ],
      "etag": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "rotation": 1,
    "watermarkLabel": "text",
    "imageFileStorageHandle": "text",
    "imageFileCreatedAt": "2026-02-10",
    "imageFileDuration": 1
  }
]

Create new Image Transformation

post

Path parameters

idinteger · int64Required

image id

Body

application/json

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

uiKeystringOptional

zur Unterscheidung verschiedener Transformationen

sizeXinteger · int32Optional

Breite in pixeln

sizeYinteger · int32Optional

Höhe in pixeln

rotationinteger · int32Optional

Rotation in Grad

watermarkLabelstringOptional

Ein Wasserzeichen

imageFileStorageHandlestringRead-onlyOptional

interne referenz auf die physikalische datei

imageFileCreatedAtstring · dateRead-onlyOptional

wann wurde die physikalische datei erstellt

imageFileDurationinteger · int32Optional

wie viele Tage bleibt diese physikalische datei erhalten (0 = unlimited)

Responses

200

successful operation

application/json

422

Resource was not valid to process

application/json

post

/dms/resources/{id}/transformations

HTTPcURLJavaScriptPython

POST /api/dms/resources/{id}/transformations HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 496

{
  "version": "text",
  "info": {},
  "id": "text",
  "uiKey": "text",
  "share": {
    "version": "text",
    "info": {},
    "id": "text",
    "publicUrlDurationInMinutes": 1,
    "availability": "UNLIMITED",
    "appId": "123e4567-e89b-12d3-a456-426614174000",
    "sharedByExternalRef": "text",
    "custom": {},
    "publishState": "SYNCED",
    "translatableTexts": [
      {
        "version": "text",
        "info": {},
        "id": "text",
        "alternativeText": "text",
        "metaTitle": "text",
        "languageCode": "text"
      }
    ],
    "etag": "text"
  },
  "sizeX": 1,
  "sizeY": 1,
  "rotation": 1,
  "watermarkLabel": "text",
  "imageFileDuration": 1
}

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:02:48.233Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:02:48.233Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "uiKey": "text",
  "share": {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:02:48.233Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:02:48.233Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "publicUrlPath": "text",
    "publicUrlCreatedAt": "2026-02-10",
    "publicUrlDurationInMinutes": 1,
    "availability": "UNLIMITED",
    "timesUsed": 1,
    "appId": "123e4567-e89b-12d3-a456-426614174000",
    "sharedByExternalRef": "text",
    "revision": 1,
    "eTag": "text",
    "custom": {},
    "publishState": "SYNCED",
    "translatableTexts": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:02:48.233Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:02:48.233Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "alternativeText": "text",
        "metaTitle": "text",
        "languageCode": "text"
      }
    ],
    "etag": "text"
  },
  "sizeX": 1,
  "sizeY": 1,
  "rotation": 1,
  "watermarkLabel": "text",
  "imageFileStorageHandle": "text",
  "imageFileCreatedAt": "2026-02-10",
  "imageFileDuration": 1
}

download the transformed image

get

Path parameters

idinteger · int64Required

image id

transformationIdinteger · int64Required

transformationId

Query parameters

dispositionstringOptional

optional: gewünschte Content-Disposition vom Request

Header parameters

If-None-MatchstringOptional

Responses

200

Response contains File

application/jsonapplication/*

Responseobject

201

Response with download-url

application/jsonapplication/*

303

Location attribute contains alternate download location

application/jsonapplication/*

422

Resource was not valid to process

application/jsonapplication/*

get

/dms/resources/{id}/transformations/{transformationId}/file

HTTPcURLJavaScriptPython

GET /api/dms/resources/{id}/transformations/{transformationId}/file HTTP/1.1
Host: localhost:53907
Accept: */*

{}