(NEW!) Create an Asset

Use this endpoint to perform one of the following:

  • Create a new Asset
  • Create a new version of an existing Asset
  • Create a new Metadata-only Asset

Once the new Asset or version is created, a new object ID is returned in the response 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 endpoint, the response will 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.

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.

Request Body schema: application/json

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.

One of:
filename
string

The name of the file if creating a content based Asset.

metadataTemplateId
string <uuid>

The UUID (system id) of the Metadata Template to be used.

securityTemplateIds
Array of strings <uuid> [ 1 .. 50 ] items
Array of attribute (object) or table (object)
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 Invalid Metadata Template

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