Skip to main content

Get Session Resource

Retrieves the details of a single mounted resource in a session.

Prerequisites

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

Endpoint

GET /sessions/{session_id}/resources/{resource_id}

Path parameters

FieldRequiredTypeDescription
session_idYesstringSession ID, format sesn_<ULID>
resource_idYesstringResource ID, format sesrsc_<ULID>

Request example

curl -X GET "$AGENTSTUDIO_URL/sessions/sesn_xxx/resources/sesrsc_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response example

{
  "id": "sesrsc_xxx",
  "type": "file",
  "file_id": "file_xxx",
  "mount_path": "/mnt/session/uploads/data.csv",
  "created_at": "2026-05-28T08:23:11Z",
  "updated_at": "2026-05-28T08:23:11Z",
  "request_id": "xxx"
}

Response fields

FieldTypeDescription
idstringResource ID, format sesrsc_<ULID>
typestringResource type, always file
file_idstringFile ID of the internal copy
mount_pathstringFull mount path with the /mnt/session/uploads/ prefix
created_atstringCreation time, ISO 8601
updated_atstringLast update time, ISO 8601
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