POST
Upload a session artifact

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}$

Query Parameters

filename
string
required

Bare file name (1-255 characters).

Required string length: 1 - 255

Body

application/octet-stream

The body is of type file.

Response

The stored artifact, with its SHA-256 digest and size.

id
string
required
Pattern: ^art_[a-z2-7]{26}$
org_id
string
required
Pattern: ^org_[a-z2-7]{26}$
project_id
string
required

Project ID (proj_...).

Pattern: ^proj_[a-z2-7]{26}$
agent_id
string
required
Pattern: ^agt_[a-z2-7]{26}$
created_at
string<date-time>
required
session_id
string

Session that owns the artifact; absent for an agent-level artifact.

Pattern: ^ses_[a-z2-7]{26}$
origin
enum<string>

input: uploaded to the session, sent as message media or received from an integration. machine_upload: uploaded by the agent from its machine (storage_upload). tool_output: written by a tool (oversized results, MCP media, viewed images).

Available options:
input,
machine_upload,
tool_output
content_type
string
filename
string
digest
string
size_bytes
integer<int64>