Skip to main content
GET
Get one attached file

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Path Parameters

session_id
string<uuid>
required

Session id (UUID) as returned by startSession or listSessions.

resource_id
string<uuid>
required

Resource id as returned by addSessionResources or listSessionResources.

Response

A file attached to a session. The file is placed read-only in the session's sandbox under its files directory, and the agent knows it is there, so it can read it with read_file or from a shell without being told where to look.

A file attached to a session. The file is placed read-only in the session's sandbox under its files directory, and the agent knows it is there, so it can read it with read_file or from a shell without being told where to look.

byte_size
integer<int64>
required

Size of the file in bytes.

created_at
string<date-time>
required

When the resource was attached.

file_id
string
required

The attached file.

filename
string
required

The file's name at upload.

media_type
string
required

The file's declared media type.

relative_path
string
required

Where the file lands relative to the session's files directory. Defaults to the filename; set it on attach to rename the file or place it in a subdirectory.

resource_id
string
required

Server-assigned id of the attachment, used to detach it.

sha256
string
required

SHA-256 of the bytes the session mounts. Frozen at attach: a later change to the file does not change this session.

type
enum<string>
required

Always file.

Available options:
file
mount_path
string

The absolute path where the file is readable inside the sandbox. Absent until staging reaches the sandbox; a resource attached mid-session is staged on the next sandbox call.