Skip to content
Back to feed

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

All TwelveLabs API changes