Actions21
- Assistant Actions
- Callback Actions
- Chat Actions
- File Actions
- Message Actions
- Peer Agent Actions
File → Upload a File
AI-generatedSummary
Upload the first input item's binary file to BGOS using a presigned S3 URL, then save its metadata and return the resulting file record with success: true. Use the returned file ID when attaching the file in a message operation.
Inputs
- Binary Property (required) — Name of the input item's binary property containing the file; defaults to
data. The operation reads the first input item and errors if that property has no binary data. - File Name — Optional name override. If blank, uses the binary file's name, or a generated
file_<timestamp>name if none is present. - User ID (required) — BGOS user ID; if blank, uses
user_idoruserIdfrom the input item's JSON. The operation errors if neither is available.
Output shape
A single output item per input item, containing the input JSON merged with the BGOS file record and success: true.
Uploads the binary content, then registers its key, MIME type, and byte size with BGOS. MIME type defaults to
application/octet-streamwhen absent. Requires configured BGOS API credentials; failures stop the operation unless Continue On Fail is enabled, in which case the output includessuccess: falseand anerrormessage.