Agents (Research preview)Knowledge store items

Create a knowledge store item

This method adds an asset to a knowledge store for processing. The operation is asynchronous. The item is created immediately with the queued status and processed in the background.

The asset must not exceed 5 GB.

Authentication

x-api-keystring
Your API key. <Note title="Note"> You can find your API key on the <a href="https://playground.twelvelabs.io/dashboard/api-keys" target="_blank">API Keys</a> page. </Note>

Path parameters

knowledge_store_idstringRequired
The unique identifier of the knowledge store.

Request

This endpoint expects an object.
asset_idstringRequired
The unique identifier of the asset to add to the knowledge store.
asset_typeenumOptional
The type of item to create.
Allowed values:
metadatamap from strings to stringsOptional
Custom metadata for the item. Both keys and values must be strings.

Response headers

Locationstring

The URL of the knowledge store item. Format: /knowledge-stores/{knowledge_store_id}/items/{item_id}.

Response

The item creation request has been accepted and is processing.
asset_typeenum
The type of item.
_idstring
The unique identifier of the knowledge store item.
asset_idstring
The unique identifier of the source asset.
statusenumRead-only

The processing status of the item. For the meaning of each value, see the Item statuses section on The knowledge store item object page.

system_metadataobjectRead-only

System-generated media metadata for the source asset. Its asset_type field always matches the item’s top-level asset_type field.

metadatamap from strings to strings
Custom metadata for the item.
created_atstringformat: "date-time"
The date and time when the item was created, in the RFC 3339 format.
updated_atstringformat: "date-time"
The date and time when the item was last updated, in the RFC 3339 format.

Errors

400
Bad Request Error