v1

latestOpenAPI 3.1.02026-07-2419782400.4 KB

Asset Usage V1

Retrieve all events performed in a given asset

This endpoint will allow you to retrieve all the events performed in a given asset.

get/v7/analytics/api/v1/asset/{assetId}

Path parameters

assetIdstring required

Example:00000000-0000-0000-0000000000000000

Asset id.

Query parameters

limitinteger

Example:100

The maximum number of analytics events to retrieve. Allowed values are between 1 and 10000.

cursorstring

Example:MTAwMA

Cursor mark returned in the response headers to be used for pagination purposes.

fromDateTimestring date-time

Example:2022-01-01T01:00

Retrieve events performed in a given asset occurred after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.

toDateTimestring date-time

Example:2022-06-01T01:00

Set a date range together with the "fromDateTime" parameter.

Response

Successful response

idstring

eventTypestring

userIdstring

dateTimestring date-time

assetIdstring

assetTypestring

assetNamestring

assetAuditstring

fileNamestring

mediaItemIdstring

mediaItemTypestring

Example response

[
  {
    "id": "62de6d714e29485a81824fe3",
    "eventType": "asset.download",
    "userId": "1A84D758-2B3A-141F-8F07D71AA1F223BD",
    "dateTime": "2021-11-15T10:07:57.781+00:00",
    "assetId": "CA510292-E39E-4B28-AB6444CDD2B1C5C0",
    "assetType": "image",
    "assetName": "Product Insights",
    "assetAudit": "ACCEPTED",
    "fileName": "CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights",
    "mediaItemId": "69293464-7721-4062-9E05EFAF23FE70E7",
    "mediaItemType": "original"
  }
]