(NEW!) Retrieve an Asset

Retrieves an asset's details and metadata by specifying an Asset Identifier or File Identifier in the request path.

** The user requesting the Asset must have view access to the Asset. **

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

The Asset Identifier (same as objectId) to retrieve.

query Parameters
empty
boolean

Default is true. When false, results will not include metadata without values, when true all metadata attributes for the asset will be returned even those with no values provided.

system
boolean

Default is true. When false, system metadata fields will be excluded from the metadata array that is returned in the response.

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.

Content-Type
required
string
Value: "application/json"
Responses
200

Success

401

Unauthorized. Missing Authorization or AccessToken or Access Token expired. Also occurs if the user does not have the permission to perform the action.

403

Forbidden. Missing X-API-key or Asset Not Found.

get/assets/asset/{id}
Request samples
Response samples
application/json
{}