assets

Enable storage accounting for an asset

Changed on

This method enables storage accounting for the specified asset. Storage accounting makes an asset count toward your Managed Intelligence allowance.

When to use this method: Call it once for each asset that you uploaded before your plan moved to the new billing (a pre-migration asset). Enable storage accounting before you do either of the following:

  • Add the asset to a knowledge store.
  • Index the asset in an index for which Marengo is enabled.

An asset that you upload after your plan moves already counts toward your Managed Intelligence allowance. You do not need to call this method for it.

Before you call this method: The asset must have the ready status and a recorded size. To check, use the GET method of the /assets/{asset_id} endpoint and read the status and size fields.

After you call this method:

  • The asset counts toward your Managed Intelligence allowance from the moment of the call.
  • Enabling storage accounting is permanent. You cannot turn it off.
  • If storage accounting is already on, the method returns the same response and changes nothing.
put/assets/{asset_id}/storage-accounting

Request

  • Base URL: https://api.twelvelabs.io/v1.3
  • URL: https://api.twelvelabs.io/v1.3/assets/{asset_id}/storage-accounting
  • Auth: API key in header x-api-key

Path parameters

asset_idstring required

The unique identifier of the asset for which to enable storage accounting.

Request body

enabledboolean required

Enables storage accounting for the asset. The only accepted value is true.

Response

Storage accounting has been successfully enabled for the asset.

asset_idstring required

The unique identifier of the asset.

storage_accountingboolean required

Indicates whether the platform counts the asset toward your Managed Intelligence allowance.

bytesinteger required

The number of stored bytes that the platform counts for the asset.

Changes