GET
Get 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}$
artifactID
string
required

Artifact ID (art_...).

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

Response

Artifact metadata.

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>