@devries-cameron20 / composio-1 / commits / 6c79f4be5
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

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.