Create or Update Transform

PUT

https://app.mk.io/api/v1/projects/:project_name/media/transforms/:transform_name

PUT

/api/v1/projects/:project_name/media/transforms/:transform_name

curl -X PUT https://app.mk.io/api/v1/projects/project_name/media/transforms/transform_name \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "properties": {
    "outputs": [
      {
        "preset": {
          "@odata.type": "string",
          "presetName": "string"
        }
      }
    ]
  }
}'

{
  "properties": {
    "outputs": [
      {
        "preset": {
          "@odata.type": "string",
          "advancedSettingsName": "string",
          "presetName": "string"
        },
        "onError": "ContinueJob",
        "relativePriority": "Normal"
      }
    ],
    "created": "2024-01-15T09:30:00Z",
    "description": "string",
    "lastModified": "2024-01-15T09:30:00Z"
  },
  "id": "string",
  "name": "name",
  "systemData": {
    "createdAt": "2024-01-15T09:30:00Z",
    "createdBy": "string",
    "createdByType": "User",
    "internalId": "string",
    "lastModifiedAt": "2024-01-15T09:30:00Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  },
  "type": "string"
}

Create or Updates a new Transform.

RBAC Capability Required: ams.transform.create or ams.transform.update

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_namestringRequired

transform_namestringRequired

Request

This endpoint expects an object.

propertiesobjectRequired

The properties of the Transform

Response

Transform was updated

propertiesobject

The properties of the Transform

idstringOptionalRead-only

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

namestringOptionalRead-onlyformat: "^[^\^\'<>%&:\\?/*+]+$"1-260 characters

The name of the resource

systemDataobjectOptional

Metadata pertaining to creation and last modification of the resource.

typestringOptionalRead-only

The type of the resource. E.g. "Microsoft.Media/mediaservices/assets"

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error