API Referencefiles

Update a file

View as Markdown

Update one file display name or caller-owned metadata.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

fileIdstringRequired
Unique file identifier generated by BCTRL.

Headers

BCTRL-Subaccount-IdstringOptional
Optional effective subaccount context for organization API keys. Subaccount API keys are already scoped and cannot use this header to act as another subaccount.

Request

This endpoint expects an object.
metadataobject or nullOptional
namestringOptional1-200 characters

Customer-facing resource name. 1–200 characters.

Response

OK
contentTypestring
createdAtdatetime
RFC 3339 timestamp with a UTC offset.
downloadUrlstring
idstring
Unique file identifier generated by BCTRL.
namestring1-200 characters

Customer-facing resource name. 1–200 characters.

pathstring
sizeBytesinteger>=0

Non-negative number of bytes.

sourceenum
spaceIdstring
Unique space identifier generated by BCTRL.
expiresAtdatetimeOptional
RFC 3339 timestamp with a UTC offset.
metadataobject or nullOptional
runIdstringOptional
Unique run identifier generated by BCTRL.
runtimeIdstringOptional
Unique runtime identifier generated by BCTRL.
typestringOptional1-64 characters

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error