October 15, 2026 · TwelveLabs
Knowledge store search adds item_id.nin exclusion and metadata range bounds
Knowledge store search accepts item_id.nin to exclude every clip or image belonging to 1 to 20,000 listed items. You can use it on its own or with either item_id.eq or item_id.in. An item listed in nin is excluded even when eq or in selects it.
The user_metadata filter also accepts inclusive gte and lte bounds on numbers and RFC 3339 timestamps with a timezone. You can use one or both bounds. Every metadata key you specify must match. These ranges apply to custom metadata you stored on the source asset or the knowledge store item.
For searches without a tags filter, the combined 10,000-item limit still applies when you use metadata, enrichment, creation time, or location filters, including item inclusions and exclusions. A broader combined match returns 422 metadata_filter_too_broad.
For details, see the Search a knowledge store API reference and 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