Skip to main content
GET
Get file metadata
Supply the exact resource key. Workspace ownership is checked before metadata is returned. Invalid keys return 400; unauthorized keys return 403. The response contains the key and metadata, which can be null. This does not download file contents.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Query Parameters

key
string
required

S3 object key

Response

Successful Response

key
string
required
metadata
Metadata · object | null
required