GET
Get file metadata

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}$
fileID
string
required

File ID (file_...).

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

Response

File metadata.

A project file. Field names follow the Anthropic Files API (filename, mime_type, size_bytes, scope); digest and metadata are BMA extensions.

id
string
required

File ID (file_...).

Pattern: ^file_[a-z2-7]{26}$
type
enum<string>
required
Available options:
file
org_id
string
required
Pattern: ^org_[a-z2-7]{26}$
project_id
string
required

Project ID (proj_...).

Pattern: ^proj_[a-z2-7]{26}$
filename
string
required
mime_type
string
required
size_bytes
integer<int64>
required
digest
string
required

SHA-256 digest of the content, sha256:.

Pattern: ^sha256:[0-9a-f]{64}$
metadata
object
required

Caller-defined string labels.

scope
object | null
required

The session this file is scoped to; null for a project-wide file.

created_at
string<date-time>
required
source_artifact_id
string

The artifact this file was promoted from.

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