Skip to main content

List Session Resources

Paginated list of resources currently mounted in a session.

Prerequisites

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

Endpoint

GET /sessions/{session_id}/resources

Path parameters

FieldRequiredTypeDescription
session_idYesstringSession ID, format sesn_<ULID>

Query parameters

FieldRequiredTypeDescription
limitNointegerItems per page; default 20, max 100
pageNostringOpaque pagination cursor; omit on the first request, pass the next_page value from the previous response on subsequent requests

Request example

curl -X GET "$AGENTSTUDIO_URL/sessions/sesn_xxx/resources?limit=20" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response example

{
  "data": [
    {
      "id": "sesrsc_xxx",
      "type": "file",
      "file_id": "file_xxx",
      "mount_path": "/mnt/session/uploads/data.csv",
      "created_at": "2026-05-28T08:23:11.456000Z",
      "updated_at": "2026-05-28T08:23:11.456000Z"
    },
    {
      "id": "sesrsc_yyy",
      "type": "file",
      "file_id": "file_yyy",
      "mount_path": "/mnt/session/uploads/late.csv",
      "created_at": "2026-05-28T08:25:00.000000Z",
      "updated_at": "2026-05-28T08:25:00.000000Z"
    }
  ],
  "next_page": "page_xxxxxxxxxxxxx",
  "request_id": "xxx"
}

Response fields

FieldTypeDescription
dataarray<object>Array of resource objects
data[].idstringResource ID, format sesrsc_&lt;ULID&gt;
data[].typestringResource type, always file
data[].file_idstringFile ID of the internal copy
data[].mount_pathstringFull mount path with the /mnt/session/uploads/ prefix
data[].created_atstringCreation time, ISO 8601
data[].updated_atstringLast update time, ISO 8601
next_pagestringNext page cursor; pass as the page parameter to continue; null when there is no more data
request_idstringUnique request identifier

Error codes

HTTP statusError codeDescription
400InvalidParameterRequired parameter missing or invalid
401InvalidApiKeyInvalid API key provided
Flow Agent API
Sandbox API
RAG API
Long-term Memory
ParseX API
Security API
Framework Integration