Edit an Asset

Edit Asset updates an existing Asset. Asset class or type, and custom attributes are created implicitly if they do not exist.

Method and Endpoint

POST "/ecs/ecs/external/api/v1/asset/<asset_uuid>"

Request Body Parameters

Name	Type	Description
availability	string, enum	Set whether the asset can be selected. Possible values are: Y, N
content_builder_id	string, Content Builder ID	Instead of loading the image from a hosted URL or Data URL, create an image for this asset using HTML from the specified Content Builder item.
custom	map, string → string	The Asset Attributes to associate with this asset. New Attributes are created implicity if they don't exist. For example: locale: JP and segment: A3
display_time_zone	string	The timezone to show in-app timestamps for this asset. For example: UTC, Eastern Time (US & Canada)
end_datetime	datetime, ISO-8601	The date and time the asset is no longer allowed to be selected. For example: 2021-07-23T13:45:15Z
fallback	string, enum	Set whether the asset can be selected as a fallback when rules disqualify all other content. Possible values are: Y, N
image_url	string, URL, data URL	Can be either a web-accessible URL hosting an image or a base-64 encoded Data URL containing image data.
start_datetime	datetime, ISO-8601	The start date and time the asset is allowed to be selected. For example: 2021-06-23T13:45:15Z
type	string	Name of the asset's asset_class.
url	string, URL	The redirect link to use when an asset is clicked.

Example Request

POST "/ecs/ecs/external/api/v1/asset/cf868607-9eec-4e2b-ae87-3d2ca7ed7911"

BODY:
{
    "type": "Other-Icons",
    "availability": "Y",
    "fallback": "N",
    "start_datetime": "2021-07-23T00:00:00Z",
    "end_datetime": "2221-07-23T23:59:59Z",
    "display_time_zone": "Helsinki",
    "url": "https://www.example.com/einstein-content",
    "custom": { "locale": "SE" },
    "image_url": "data:image/png;base64,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"
}

Example Response

{
    "key": "Einstein Content",
    "uuid": "cf868607-9eec-4e2b-ae87-3d2ca7ed7911",
    "type": "Other-Icons",
    "url": "https://www.example.com/einstein-content",
    "image_url": null,
    "custom": {
        "locale": "SE"
    },
    "created_at": "2021-08-02T22:20:52.861Z",
    "updated_at": "2021-08-02T22:38:28.804Z",
    "availability": "Y",
    "fallback": "N",
    "file_ext": "png",
    "status": "ready",
    "image_updated_at": "2021-08-02T22:38:28.755Z",
    "image_processing_completed_at": "2021-08-02T22:38:28.802Z",
    "image_checksum": "16afe520c3489cc77f668cb2dcfa571c-1",
    "asset_class_id": "f0bc4b14-c19c-49a5-a72f-1736a2afa8f9",
    "content_builder_id": null,
    "archived": false,
    "ect_tags": null,
    "start_datetime": "2021-07-23T00:00:00.000Z",
    "end_datetime": "2221-07-23T23:59:59.000Z",
    "display_time_zone": "Helsinki",
    "image_link": "https://ecs-asset-images-qa.s3.us-west-2.amazonaws.com/3612/21575198/f/cf868607-9eec-4e2b-ae87-3d2ca7ed7911.png?v=16afe520c3489cc77f668cb2dcfa571c-1",
    "display_time_zone_name": "Europe/Helsinki",
    "display_start_datetime": "2021-07-23T03:00:00+03:00",
    "display_end_datetime": "2221-07-24T01:59:59+02:00"
}
}