List Memory Stores

Prerequisites

Endpoint and authentication configured. For details, see Overview and authentication.

Endpoint

GET /memory_stores

Query parameters

Field	Required	Type	Description
`include_archived`	No	boolean	If false (default), only unarchived stores are returned; true also returns archived ones
`limit`	No	integer	Page size, 1-100, default 20
`page`	No	string	Pagination cursor. Omit on the first call; pass next_page from the previous response to fetch the next page

Request example

curl "$AGENTSTUDIO_URL/memory_stores" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response example

{
  "data": [
    {
      "id": "memstore_xxx",
      "type": "memory_store",
      "name": "Project Knowledge",
      "description": "Project conventions, decisions, and troubleshooting notes",
      "metadata": {
        "team": "data"
      },
      "created_at": "2026-09-17T08:00:00Z",
      "updated_at": "2026-09-17T08:00:00Z"
    }
  ],
  "next_page": null
}

Response fields

Field	Type	Description
`data`	array<object>	Array of memory stores
`id`	string
`type`	string
`name`	string
`description`	string
`metadata`	object
`archived_at`	string \| null
`created_at`	string
`updated_at`	string
`next_page`	string \| null	Cursor for the next page; absent or null when there is no more data

Error codes

HTTP status	Error code	Description
400	`invalid_request_error`	Invalid parameters, path, limit, or pagination cursor
401	`InvalidApiKey`	API key missing, invalid, or expired
403	`permission_error`	Insufficient identity or resource access permissions

​Prerequisites

​Endpoint

​Query parameters

​Request example

​Response example

​Response fields

​Error codes

Prerequisites

Endpoint

Query parameters

Request example

Response example

Response fields

Error codes