Actions11
- Agent Actions
- File Actions
- Object Actions
- Utility Actions
File → Upload
AI-generatedSummary
Uploads a file to the Sapience API. For each input item, reads the binary data from the specified binary property (default: 'data'). Sends the file along with the user description, parse flag, and parent UID (default: 'root') to the /api/files/upload endpoint. Returns the API response for each item.
Inputs
- Binary Property (required) — Name of the binary property containing the file data (default: 'data')
- User Description (required) — Description to store with the file (can be empty string)
- Should Parse File (required) — Whether the backend should parse the file after upload (default: false)
- Additional Fields.Parent UID — Parent UID for the file location (default: 'root')
Output shape
The parsed JSON response from the API for each uploaded file, or the raw response if not JSON. Each input item produces one output item.
If the API returns a string, it is parsed as JSON; if that fails, an object with a 'response' field containing the string is returned.
Examples
Example 1: Upload a binary file from a previous node
Set Binary Property to 'data' (or the name of the binary property from the previous node), add a User Description if desired, leave Should Parse File unchecked unless parsing is needed, and set Parent UID to a specific UID or leave as 'root'.