Create Asset

Use this endpoint to perform one of the following operations:

  1. Create a new Asset
  2. Create a new Version of an existing Asset
  3. Create a new Metadata-only Asset

Once the new Asset or Asset Version is created, a new Object ID is returned to identify the new Asset / Asset Version.

When a new Asset is created, the Asset is considered a metadata-only asset until a corresponding content file is uploaded. The Asset's content file size must be less than or equal to 5GB.

After invoking the Create Asset service, the response shall include a signed URL to upload the content file. The upload should be performed using a PUT request with the file content attached as binary data in the request body.

After creating an asset greater than 100MB, multiple presigned URLs will be returned. You must upload file chunks of 100MB to each one.

You must call the /asset/complete endpoint to complete or cancel a multi-part file upload, otherwise the file will not be available to Tenovos.

The user submitting the request to create an Asset must have the Upload Security Role Privilege and be granted access to at least one Security Template to assign to the new Asset.

Average Response Time: 1077ms (varies based on metadata)

SecurityApiKeyAuth or BasicAuth
Request
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"
Request Body schema: application/json
required

The Request Body must be a JSON object. To create a new version instead of new asset, pass an additional property originalFileId as part of the JSON object.

originalFileId
string <uuid> = 36 characters

ID of the file. When provided a new version will be created.

metadataTemplateId
required
string <uuid> = 36 characters

ID of metadata template to apply.

required
Array of MetadataStringValue (object) or MetadataRestrictedVocabularyValue (object) or MetadataDateValue (object) or MetadataMultiValue (object) or MetadataGridValue (object) (MetadataDocument)

Array of metadata attributes

securityTemplateIds
required
Array of strings <uuid>

Array of Security Template IDs

filename
required
string

Asset file name.

contentPath
string

S3 path to the file. Required only for Federated files.

skipTranscode
boolean

Flag to skip content transformation. Required only for Federated files.

filesize
number

Size of file in bytes

Responses
200

The Response Body is a JSON object

401

Unauthorized. Missing Authorization or AccessToken or expired token

403

returns JSON object with error description.

post/asset
Request samples
application/json
{
  • "metadataTemplateId": "ea6eb24d-adef-4080-bd02-f64f567c437f",
  • "metadata": [
    ],
  • "securityTemplateIds": [
    ],
  • "filename": "apples.jpg"
}
Response samples
application/json
{
  • "status": "success",
  • "message": "Asset created successfully",
  • "data": {
    }
}