Actions12
Overview
The node integrates with the Coze AI platform, providing multiple functionalities including file upload. Specifically, the File Upload operation allows users to upload binary files to the Coze service. This is useful in scenarios where you want to programmatically send files (e.g., documents, images, or other binary data) to Coze for storage, processing, or further AI-driven workflows.
Practical examples include:
- Uploading user-generated content from a web form to Coze.
- Automating backup of files into the Coze platform.
- Feeding files into AI workflows that require input files hosted on Coze.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method used to authenticate requests. Options: "Service Token" or "OAuth2". |
| Binary Property | The name of the binary property in the input data that contains the file data to be uploaded. |
Output
The node outputs a JSON array containing the response from the Coze API after uploading the file(s). Each item in the output corresponds to one input item processed and typically includes metadata or confirmation details about the uploaded file.
If the node handles binary data, it expects the binary content to be provided as an input property named by the user (default "data"), but the output itself is JSON describing the result of the upload operation rather than returning the binary data.
Dependencies
- Requires an active connection to the Coze AI platform via either a service token or OAuth2 authentication.
- The node depends on proper configuration of credentials within n8n to authenticate API requests.
- Network access to
https://api.coze.cnis necessary.
Troubleshooting
Common issues:
- Missing or incorrect binary property name: Ensure the binary property specified actually exists in the input data.
- Authentication failures: Verify that the selected authentication method is correctly configured and valid.
- Network errors or API downtime: Check connectivity to the Coze API endpoint.
Error messages:
- Errors related to missing binary data usually indicate the binary property name does not match any input binary field.
- Authentication errors suggest invalid or expired credentials.
- API errors may return messages from Coze indicating issues like file size limits or unsupported formats.
Resolving these typically involves verifying input data structure, refreshing credentials, and consulting Coze API documentation for limits and requirements.
Links and References
- Coze AI Platform Documentation (general reference for API capabilities)
- n8n documentation on working with binary data