October 15, 2026 · TwelveLabs
Knowledge store search results can include item custom metadata
Knowledge store search results now include the custom metadata of the knowledge store item.
A knowledge store item has two sets of custom metadata: the custom metadata of the source asset and the custom metadata of the knowledge store item. The two sets are separate. The same key can have different values in each set.
When you set the include_metadata parameter to true, the metadata object of each result has these fields:
system: System-generated metadata.user: The custom metadata of the source asset.item: The custom metadata of the knowledge store item. This field is absent when no item metadata has been set.
To use this feature, upgrade to the latest version of the Python or Node.js SDK:
Python SDK
pip install --upgrade twelvelabs
Node.js SDK
npm install twelvelabs-js@latest
For details, see the Search a knowledge store page in the API Reference section, or the SDK reference for Python and Node.js.
Latest TwelveLabs API changes
Free plan now 10 requests/minute, 200/day; Plus and Pro 30/minute, 1,000/day
List knowledge stores can be filtered by asset with asset_id
TwelveLabs SDKs 1.3.8 change Responses API types, removing usage for billing
Knowledge store items can be filtered by 1 to 50 asset IDs when listing
Fractional embedding segment lengths documented as valid; Marengo 3.0 ignores the fraction