> This page is for version v1.3 (default).
> For other versions, use one of these documentation indexes:
> - v1.3 (default): https://docs.twelvelabs.io/v1.3/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.twelvelabs.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.twelvelabs.io/_mcp/server.

## Introducing location filtering for knowledge store search

Knowledge store search now accepts a `location` filter: a circle defined by a center point and a radius in meters. The search returns only items captured within the circle, based on the GPS coordinates embedded in their source media.

To use this feature, upgrade to the latest version of the Python or Node.js SDK:

**`Python SDK`**

```sh Python SDK
pip install --upgrade twelvelabs
```

**`Node.js SDK`**

```sh Node.js SDK
npm install twelvelabs-js@latest
```

For details, see the [Search a knowledge store](/v1.3/api-reference/knowledge-store-search/search) page in the API Reference section, or the SDK reference for [Python](/v1.3/sdk-reference/python/search-knowledge-store) and [Node.js](/v1.3/sdk-reference/node-js/search-knowledge-store).

## Introducing item metadata for knowledge store items

Knowledge store items now support item metadata: custom metadata of the knowledge store item, separate from the custom metadata of its source asset. Send the `item_metadata` field when you create an item.

To use this feature, upgrade to the latest version of the Python or Node.js SDK:

**`Python SDK`**

```sh Python SDK
pip install --upgrade twelvelabs
```

**`Node.js SDK`**

```sh Node.js SDK
npm install twelvelabs-js@latest
```

For details, see the [Create a knowledge store item](/v1.3/api-reference/knowledge-store-items/create) and [The knowledge store item object](/v1.3/api-reference/knowledge-store-items/the-knowledge-store-item-object) pages in the API Reference section, or the SDK reference for [Python](/v1.3/sdk-reference/python/knowledge-store-items) and [Node.js](/v1.3/sdk-reference/node-js/knowledge-store-items).

## Deprecating the `metadata` field when creating a knowledge store item

The `metadata` field of the request to create a knowledge store item is deprecated. Use `item_metadata` instead. The old name still works: the item stores the pairs you send as `metadata` in its `item_metadata` field. If your code reads `metadata` from the item, read `item_metadata` instead.

For details, see the [Create a knowledge store item](/v1.3/api-reference/knowledge-store-items/create) page in the API Reference section, or the SDK reference for [Python](/v1.3/sdk-reference/python/knowledge-store-items) and [Node.js](/v1.3/sdk-reference/node-js/knowledge-store-items).