List Session Resources

Updated at:

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

ParameterRequiredTypeDescription
session_idYesstringSession ID, format sesn_<ULID>

Query parameters

ParameterRequiredTypeDescription
limitNointegerItems per page, max 100, default 20
pageNostringPagination cursor (opaque token). Omit on the first request; on subsequent requests pass the cursor returned by the previous response

Request example

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

Response

The response contains data (an array of session resource objects) and next_page (the cursor for the next page, null when there is no more data).

{
  "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_<ULID>
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 it as the page parameter to continue paging; null when there is no more data
request_idstringUnique identifier of this request

Error codes

HTTP statusError codeDescription
400InvalidParameterRequired parameter missing or invalid.
401InvalidApiKeyInvalid API-key provided.