---
title: "Search for items within a namespace prefix."
method: POST
path: "/store/items/search"
tags: ["Store"]
---

# Search for items within a namespace prefix.

`POST /store/items/search`

## Request body

- StoreSearchRequest — Request to search for items within a namespace prefix.
  - `namespace_prefix` string[], nullable — List of strings representing the namespace prefix.
  - `filter` object, nullable — Optional dictionary of key-value pairs to filter results.
  - `limit` integer — Maximum number of items to return (default is 10).
  - `offset` integer — Number of items to skip before returning results (default is 0).

## Response `200`

Success

- SearchItemsResponse
  - `items` Item[], required
    - `namespace` string[], required — The namespace of the item. A namespace is analogous to a document's directory.
    - `key` string, required — The unique identifier of the item within its namespace. In general, keys needn't be globally unique.
    - `value` object, required — The value stored in the item. This is the document itself.
    - `created_at` string, date-time, required — The timestamp when the item was created.
    - `updated_at` string, date-time, required — The timestamp when the item was last updated.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/xpert-ai/apis/agent-protocol.md) · [All operations](https://skmtc.dev/xpert-ai/apis/agent-protocol/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xpert-ai/agent-protocol/revisions/ac9dbe16ea2f/schema)