Get Asset

Retrieve an Asset's details and metadata by specifying an Object ID or File ID in the request path.

The user requesting the Asset must have view access to the Asset in order to retrieve the Asset.

Average Response Time: 451ms (Get asset by fileId)

Average Response Time: 2973ms (Get asset by objectId)

SecurityApiKeyAuth or BasicAuth
Request
path Parameters
id
required
string <uuid> = 36 characters

Asset Object ID or File ID

header Parameters
X-API-Key
required
string

Customer-specific API key required to invoke API.

Authorization
required
string

Provided by Authentication Token creation operation

AccessToken
required
string

JWT token provided by Authentication Token creation operation.

Responses
200

Returns JSON object

401

Unauthorized. Missing Authorization or AccessToken or expired token

403

returns JSON object with error description.

get/asset/{id}
Request samples
Response samples
application/json
{
  • "createdBy": "7d675ef0-f423-11e9-8071-89c0c405214e",
  • "createdEpoch": 1608745510614,
  • "currentVersion": "Y",
  • "customerId": "123203455",
  • "fileId": "a1c6a2ab-4b01-4253-b4c9-70e04b3b48fc",
  • "filename": "adventure-alps-beautiful-landscape-2444403.jpg",
  • "fileState": "available",
  • "lastUpdatedBy": "7d675ef0-f423-11e9-8071-89c0c40133ds",
  • "lastUpdatedEpoch": 1612333543954,
  • "metadata": [
    ],
  • "metadataDenormalized": { },
  • "metadataState": "available",
  • "metadataTemplateId": "ea6eb24d-adef-4380-bd02-f64f567c437f",
  • "objectId": "e6f4bd5e-9bea-43cb-b15e-22582fa5322e",
  • "objectType": "Asset",
  • "originalFileId": "003391e4-e78a-4186-b2d7-b5d4fcbe445d",
  • "securityTemplateIds": [
    ],
  • "securityDenormalized": [
    ],
  • "technicalMetadata": {
    },
  • "versionNumber": 0,
  • "presignedURL": "string",
  • "linkType": "string",
  • "relationshipId": "928dd5b8-3ead-4528-bdef-9c0b867a5d7d",
  • "secondaryId": "string"
}