Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 22, 15:45 UTC
docs: add changelog for proxy execute binary data support (#2318)
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Co-authored-by: himanshu@composio.dev <himanshu@composio.dev> Co-authored-by: Sushmitha Mallesh <sushdec6@gmail.com>
devin-ai-integration[bot] committed
Jan 4, 2026 at 14:58 UTC
6c79f4be56ee0c155f812cdbed4be861f2acf5ba
1 file changed
+88
fern/pages/src/changelog/12-30-25-proxy-binary-data.md
new
+88
@@ -0,0 +1,88 @@
1
+## Binary Data Support for Proxy Execute
2
+
3
+The `/api/v3/tools/execute/proxy` endpoint now supports binary data for both file uploads and downloads.
4
+
5
+### File Uploads (`binary_body`)
6
+
7
+To upload a file via the proxy, use the `binary_body` field in your request payload. This supports two approaches: specifying either a URL pointing to the file or providing the base64-encoded content directly.
8
+
9
+#### Upload File via URL
10
+
11
+```bash
12
+curl --location 'https://backend.composio.dev/api/v3/tools/execute/proxy' \
13
+ --header 'accept: application/json' \
14
+ --header 'x-api-key: <YOUR_API_KEY>' \
15
+ --header 'Content-Type: application/json' \
16
+ --data '{
17
+ "endpoint": "/upload-endpoint",
18
+ "method": "POST",
19
+ "connected_account_id": "<CONNECTED_ACCOUNT_ID>",
20
+ "binary_body": {
21
+ "url": "{URL_TO_THE_FILE}"
22
+ }
23
+ }'
24
+```
25
+
26
+#### Upload File via Base64 Content
27
+
28
+Supported up to 4MB file size.
29
+
30
+```bash
31
+curl --location 'https://backend.composio.dev/api/v3/tools/execute/proxy' \
32
+ --header 'accept: application/json' \
33
+ --header 'x-api-key: <YOUR_API_KEY>' \
34
+ --header 'Content-Type: application/json' \
35
+ --data '{
36
+ "endpoint": "/upload-endpoint",
37
+ "method": "POST",
38
+ "connected_account_id": "<CONNECTED_ACCOUNT_ID>",
39
+ "binary_body": {
40
+ "base64": "JVBERi0xLjQKJ...<base64_data>...",
41
+ "content_type": "application/pdf"
42
+ }
43
+ }'
44
+```
45
+
46
+### File Downloads (`binary_data`)
47
+
48
+When the proxied request returns a binary response (for example, a PDF or image), the proxy automatically uploads the file to temporary storage, and you receive a signed URL in the `binary_data` field. This enables you to download large files securely.
49
+
50
+#### File Download Request
51
+
52
+```bash
53
+curl --location 'https://backend.composio.dev/api/v3/tools/execute/proxy' \
54
+ --header 'accept: application/json' \
55
+ --header 'x-api-key: <YOUR_API_KEY>' \
56
+ --header 'Content-Type: application/json' \
57
+ --data '{
58
+ "endpoint": "{YOUR_ENDPOINT}",
59
+ "method": "GET",
60
+ "connected_account_id": "{YOUR_CONNECTED_ACCOUNT_ID}"
61
+ }'
62
+```
63
+
64
+#### File Download Response
65
+
66
+```json
67
+{
68
+ "data": {},
69
+ "binary_data": {
70
+ "url": "url to the file",
71
+ "content_type": "content type of the file",
72
+ "size": "size of the file",
73
+ "expires_at": "expires at of the file"
74
+ },
75
+ "status": "status code of the response",
76
+ "headers": "headers of the response"
77
+}
78
+```
79
+
80
+### Summary
81
+
82
+| Feature | Field | Description |
83
+|---------|-------|-------------|
84
+| File Upload via URL | `binary_body.url` | Provide a URL pointing to the file to upload |
85
+| File Upload via Base64 | `binary_body.base64` + `binary_body.content_type` | Provide base64-encoded content (up to 4MB) |
86
+| File Download | `binary_data` in response | Receive a signed URL to download binary responses |
87
+
88
+We'd love your feedback on the new proxy execute capabilities. If anything feels unclear or you have suggestions for improvement, please reach out.