All Products
Search
Document Center

Tablestore:List memory stores

Last Updated:Sep 24, 2026

Use the ListMemoryStores operation to list memory stores in the current AgentStorage instance in a paginated manner. Each list item includes the input and output types, which can be used to distinguish structured memory, service-generated files, and application-managed files.

Prerequisites

  • An AgentStorage instance has been created and is in the normal state, and the instance endpoint and instance name have been obtained.

  • An API Key has been created.

Request parameters

Field

Type

Required

Description

limit

int

No

The maximum number of entries to return on this page.

nextToken

string

No

The opaque pagination token returned by the previous page.

Request example

When using API Key authentication, pass the instance name and API Key through the x-ots-instancename and x-ots-apikey request headers.

curl -X POST https://<endpoint>/ListMemoryStores \
  -H "x-ots-instancename: <instance-name>" \
  -H "x-ots-apikey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{}'

Response

Field

Description

stores

The list of memory stores.

stores[].memoryStoreName

The name of the memory store.

stores[].inputType

The input type: messages or file.

stores[].outputTypes

The set of output types, whose elements are structured or file.

nextToken

The token for the next page; omitted when there is no more data.

{
  "stores": [
    {
      "memoryStoreName": "agent_memory",
      "inputType": "messages",
      "outputTypes": ["structured", "file"]
    },
    {
      "memoryStoreName": "agent_files",
      "inputType": "file",
      "outputTypes": ["file"]
    }
  ]
}