List Memory Stores API: GET /memory_stores-Alibaba Cloud Model Studio(Model Studio)-阿里云帮助中心

Lists memory stores of the current workspace in reverse creation order. Archived stores are excluded by default.

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