Document namespace filters for session listing

[abrookins]

Summary

Document how to discover session IDs by namespace, optionally combined with an owner filter. Add curl examples and explain exact ID matching, pagination, and the conflict with includeAll=true. Add the matching namespaceRef query parameter to the API reference.

How Has This Been Tested?

• All ListSessions parameter definitions match the generated API artifact.
• All local OpenAPI references resolve.
• All three curl examples pass shell syntax checks and execute against a local HTTP fixture with the expected paths, query parameters, and authorization headers.
• Hugo 0.143.1 renders the Agent Memory pages; the new section and its cross-reference targets were checked in the HTML.
• git diff --check passes.

The examples were validated with a fixture, not a deployed service.

CI on 514308efb completed: 97 checks passed, three configured jobs skipped (RDI build/deploy and the production-only 404 deployment), and no failures or pending checks. All versioned builds and staging deployments passed.

Linked Items

Based on #4001, which adds the Sessions page and namespace examples. Merge after that PR and availability of the namespace session filter.

Breaking Changes

None.

Checklist

• Follows the documentation style in this section.
• Validated the changed examples and API definition.
• Updated the guide and API reference together.

---

Note

Low Risk
Documentation and OpenAPI metadata only; no runtime or behavioral code changes.

Overview
Documents how to list session IDs via GET /v1/stores/{storeId}/session-memory, with emphasis on the new namespaceRef query filter and how it interacts with existing filterOwnerId and includeAll.

The OpenAPI spec for ListSessions now includes namespaceRef: exact, case-sensitive match on stable namespace ID; excludes deprecated label-only sessions and descendant namespaces; AND-combined with filterOwnerId; mutually exclusive with includeAll.

The sessions guide adds a List sessions section with curl examples (namespace-only, namespace + owner, and includeAll=true), notes on filter semantics and pagination (items, total, pageToken), and a link to the API reference.

^{Reviewed by Cursor Bugbot for commit 514308e. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

🧠 Redis Memory

Found 5 related items from repository history (5 new this commit):

• PR — MOD-18613: Document Agent Memory namespaces and custom memory usage 🆕

  Summary

• PR — DOC-6436 session store other clients 🆕

  This extends the original Python example with code for the other clients. Note that this is all still hidden in the navigation - I'll add an

• PR — DOC-7032: Add tested client examples for JSONPath functions 🆕

  Summary

• Commit — DOC-7032: Fold function descriptions into their Filter examples entries 🆕

  DOC-7032: Fold function descriptions into their Filter examples entries

• Commit — DOC-7032: Fold function descriptions into their Filter examples entries 🆕

  DOC-7032: Fold function descriptions into their Filter examples entries

Memory updated at 514308e

[github-actions]

Staging links:
https://redis.io/docs/staging/docs/session-namespace-filter/develop/ai/context-engine/agent-memory/sessions/

[abrookins]

I should combine this with #4001 and tighten it up