Asset Get Metadata
  • 2 Minutes to read
  • Dark
    Light

Asset Get Metadata

  • Dark
    Light

Article summary

To get an asset's metadata, mention the following in the postman and then click Send.

GET


How to update the metadata?

To update the asset's metadata, pull the asset's metadata by using a GET call, and then update its attributes by changing the call method to PUT.

Headers

Authorization: Specify required Auth Token in the header.

Request Parameters

Expand to see the parameters and description


Parameter  Parameter TypeData TypeAccepted ValuesDescription
NameRequiredStringAn asset filename.Specifies the asset's filename.
TagsOptionalArray of StringsAny tags desired.Provides an array of tags applicable to an asset.
BinaryAssetIdRequired
StringGUIDBinary asset identifier.
CollectionCountOptionalIntegerCollection countA number of collections.
UploadDateRequired
IntegerYYYY-MM-DDDetermines an upload date.
SourceUrlRequired
StringAn asset's source URLEnsures the asset is not duplicated. 
StatsRequired
Array of StringsAsset detailsIncludes information about the asset file.
IdPart of StatsStringAn asset GUIDIt's an asset identifier.
BinaryIdPart of StatsStringThe binary file GUIDIdentifier of a binary file.
HashPart of StatsStringChecksum used for validationContains a hash for the validation of assets.
DescriptionPart of StatsStringA file nameDescribes a file name.
HeightPart of StatsIntegerHeight in pixelsDefines an asset height.
WidthPart of StatsIntegerWidth in pixelsDefines an asset width.
FormatPart of StatsStringA file formatDefines a file format for example: jpg, png, jpeg.
FileSizePart of StatsIntegerSize in bytesGives info about the file size.
DPIPart of StatsFloatDPI of an asset.Provides info about an asset DPI.
HasClippingPathPart of StatsBooleanTrue/FalseDefines if an asset has a clipping path included.
FramesPart of StatsIntegerDefault is 1
DurationPart of StatsFloatDefault is 0.0
CodecPart of StatsStringCodec type e.g. mjpegSets a codec type of an image.
IsArchivedOptionalBooleanTrue/FalseDefines if an asset is archived.
AltTextOptionalArray of StringsIncludes a locale and a description.Used for accessibility purposes.
IdRequired
StringAsset GUID.It's an asset identifier.
DataOwnerRequired
String
GUID
Company ID GUID
AuditInfoOptionalArray of StringsExamples: CreateDate, CreatorName.Provides audit data.
ContextIdPart of AuditInfoStringContext GUID
CreateDatePart of AuditInfoStringYYYY-MM-DDProvides a create date.
CreatorIdPart of AuditnfoStringCreator GUIDProvides the creator identifier.
CreatorNamePart of AuditInfoStringCreator first & last nameProvides info on the creator of the asset.
LastModifiedDatePart of AuditInfoStringYYYY-MM-DDShows the last modified date.
PrincipleId
Part of AuditInfoStringPrinciple GUIDAn identifier of the principle.
PrincipleName
Part of AuditInfoStringPrinciple first & last name
MachineName
Part of AuditInfoStringMachine Id
Properties
Required
Array of StringsAsset properties
Provides you with information about the asset properties.
SpecialPurpose
Part of PropertiesStringExample:
Ad, Marketing
Used for specifying the purpose of an asset. 
Variant
Part of Properties
String
TBAMakes it easy to set variants for assets.
CPVIdentifier
Part of Properties
String
Identifier
TBA
ContentDescription
Part of Properties
String
A description of the asset's contentTBA
FileFormatDescription
Part of Properties
String
File format description.
FileOptimalViewerName
Part of Properties
String


FileOriginCountry
Part of Properties
String
Country of origin
FileCameraPerspective
Part of Properties
String
Example: FrontProvides information about the camera perspective.
IsPrimaryFile
Part of Properties
BooleanTrue/FalseDefines if the file is primary.
IsBackgroundTransparent
Part of Properties
Boolean
True/False
Marks if the background of an asset is transparent.
AssetMetadataIsLocked
Part of Properties
Boolean
True/False

Response 200 OK


{
    "Name": "ac_sy300.jpg",
    "BinaryAssetId": "e548edb5-729b-4542-8187-2817149cbf37",
    "CollectionCount": 0,
    "UploadDate": "2023-06-21T10:45:44.7724417Z",
    "SourceUrl": "https://m.media-amazon.com/images/I/612yLr7777S._AC_SY300_SX300_.jpg",
    "Stats": {
        "id": "4d89e018-fb7b-49bf-b8e9-49fb99bd24e3",
        "BinaryId": "e548edb5-729b-4542-8187-2817149cbf37",
        "Hash": "a59e4e0f42d38233c746697b88cc937539a14845cd0911c761349de76cd86cb9",
        "Description": "ac_sy300.jpg",
        "Height": 300,
        "Width": 300,
        "Format": "jpeg",
        "FileSize": 14726,
        "Dpi": {
            "X": 0.0,
            "Y": 0.0
        },
        "HasClippingPath": false,
        "Frames": 1,
        "Duration": 0.0,
        "Codec": "mjpeg"
    },
    "IsArchived": false,
    "AltText": {},
    "id": "4d89e018-fb7b-49bf-b8e9-49fb99bd24e3",
    "DataOwner": "3b904928-20b7-413e-bda6-28edf4b2ff31",
    "AuditInfo": {
        "ContextId": "922aa947-5919-4b3c-ad23-38b84f897696",
        "CreateDate": "2023-06-21T10:45:44.7928019Z",
        "CreatorId": "a56dcfe1-b1e8-465c-af6d-625f32302258",
        "CreatorName": "Daniel Retkiewicz",
        "LastModifiedDate": "2024-01-24T17:01:41.3339518Z",
        "PrincipleId": "a56dcfe1-b1e8-465c-af6d-625f32302258",
        "PrincipleName": "Daniel Retkiewicz",
        "MachineName": "assetservice-f98979cfb-mjkcl"
    },
    "Properties": {
        "SpecialPurpose": "Ad",
        "Variant": "1",
        "CPVIdentifier": "TEST",
        "ContentDescription": "Description",
        "FileFormatDescription": "it is a jpg and It has been updated through API",
        "FileOptimalViewerName": "Front",
        "FileOriginCountry": "Bing",
        "FileCameraPerspective": "Rear",
        "IsPrimaryFile": "false",
        "IsBackgroundTransparent": "false",
        "AssetMetadataIsLocked": "false"
    },
    "Partition": "4d89e018-fb7b-49bf-b8e9-49fb99bd24e3",
    "Type": "Asset"
}


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Eddy AI, facilitating knowledge discovery through conversational intelligence