Logo
Akamai APIs API Documentation

Create or modify a policy

PUT https://{{host}}/imaging/v2/network/:network/policies/:policyId

Run this operation to update an existing policy or create a new policy. Run the List policies operation to get the list of existing policies and their policy IDs. Confirm the policyId doesn't already exist.

 

Body PARAM

Key Datatype Required Description 
accountSwitchKey
string (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).



HEADERS

Key Datatype Required Description 
Contract
string Unique identifier for the Akamai Contract containing the policy sets. Required if you have access to more than one contract with Image & Video Manager.
Policy-Set
string (Required) Unique identifier for the Image & Video Manager policy set.
Content-Type
string
Accept
string




RESPONSES

status Created

Curl
curl -X PUT 'https://host/imaging/v2/network/:network/policies/:policyId?accountSwitchKey=' -H 'Contract: ' -H 'Policy-Set: Policy-Set' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"breakpoints":{"widths":[720,1280,1920,5000]},"output":{"perceptualQuality":"mediumHigh"},"transformations":[{"gravity":"SouthWest","image":{"url":"www.customer.com/watermark.png"},"transformation":"Composite","xPosition":0,"yPosition":0}]}'

ENDPOINTS