POST
Mount a file into a session

Authorizations

Authorization
string
header
required

An opaque BMA personal or organization bearer token.

Path Parameters

orgID
string
required

Organization ID (org_...).

Pattern: ^org_[a-z2-7]{26}$
projectID
string
required

Project ID (proj_...).

Pattern: ^proj_[a-z2-7]{26}$
agentID
string
required

Agent ID (agt_...).

Pattern: ^agt_[a-z2-7]{26}$
sessionID
string
required

Agent session ID (ses_...).

Pattern: ^ses_[a-z2-7]{26}$

Body

application/json
type
enum<string>
required
Available options:
file
file_id
string
required

File ID (file_...).

Pattern: ^file_[a-z2-7]{26}$
mount_path
string | null

Absolute path below /mnt/session/uploads; a path outside it is placed under it (/data.csv mounts at /mnt/session/uploads/data.csv). Defaults to /mnt/session/uploads/<file_id>.

Required string length: 1 - 4096

Response

The mounted file.

A file mounted into a session. file_id is the session instance created for the mount, not the mounted file's id; GET /files/{file_id} and its content read it.

id
string
required
Pattern: ^sesrsc_[a-z2-7]{26}$
type
enum<string>
required
Available options:
file
file_id
string
required

File ID (file_...).

Pattern: ^file_[a-z2-7]{26}$
mount_path
string
required

Absolute path the session's tools read the file at.

filename
string
required
mime_type
string
required
size_bytes
integer<int64>
required
digest
string
required
Pattern: ^sha256:[0-9a-f]{64}$
created_at
string<date-time>
required
updated_at
string<date-time>
required