Transformations

Updates the definition of an existing transformation

PUT
/v1_1/{cloud_name}/transformations/{transformation}

Updates a named or unnamed transformation.

Authorization

AuthorizationBasic <token>

Basic authentication using Cloudinary API Key and API Secret.

In: header

Path Parameters

cloud_name*string

The cloud name of your product environment.

transformation*string

The transformation identifier. Can be either a named transformation (e.g., 'small_profile_thumbnail') or a transformation string (e.g., 'w_100,h_150,c_fill,g_auto').

Request Body

application/json

The updated transformation definition.

unsafe_update?string

Required when modifying the transformation parameters of an existing named transformation. The new transformation definition for the named transformation. Because the changed definition can be unsafe for (significantly change) assets in production, the change is applied only to newly generated derived assets that reference this named transformation.

To apply the change to existing derived assets using this named transformation, invalidate them so that they'll be regenerated with the new definition when next requested.

allowed_for_strict?allowed_for_strict

Whether to allow this named transformation when strict transformations are enabled. Strict transformations prevent transformations from being dynamically applied to media assets.

Response Body

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1_1/my_cloud/transformations/small_profile_thumbnail" \  -H "Content-Type: application/json" \  -d '{}'
{  "message": "string"}