Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: add changelog for proxy execute binary data support (#2318)
devin-ai-integration[bot]6c79f4be56ee
diff --git a/fern/pages/src/changelog/12-30-25-proxy-binary-data.md b/fern/pages/src/changelog/12-30-25-proxy-binary-data.mdnew file mode 100644index 000000000..837eb02b0--- /dev/null+++ b/fern/pages/src/changelog/12-30-25-proxy-binary-data.md@@ -0,0 +1,88 @@+## Binary Data Support for Proxy Execute++The `/api/v3/tools/execute/proxy` endpoint now supports binary data for both file uploads and downloads.++### File Uploads (`binary_body`)++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.++#### Upload File via URL++```bash+curl --location 'https://backend.composio.dev/api/v3/tools/execute/proxy' \+ --header 'accept: application/json' \+ --header 'x-api-key: <YOUR_API_KEY>' \+ --header 'Content-Type: application/json' \+ --data '{+ "endpoint": "/upload-endpoint",+ "method": "POST",+ "connected_account_id": "<CONNECTED_ACCOUNT_ID>",+ "binary_body": {+ "url": "{URL_TO_THE_FILE}"+ }+ }'+```++#### Upload File via Base64 Content++Supported up to 4MB file size.++```bash+curl --location 'https://backend.composio.dev/api/v3/tools/execute/proxy' \+ --header 'accept: application/json' \+ --header 'x-api-key: <YOUR_API_KEY>' \+ --header 'Content-Type: application/json' \+ --data '{+ "endpoint": "/upload-endpoint",+ "method": "POST",+ "connected_account_id": "<CONNECTED_ACCOUNT_ID>",+ "binary_body": {+ "base64": "JVBERi0xLjQKJ...<base64_data>...",+ "content_type": "application/pdf"+ }+ }'+```++### File Downloads (`binary_data`)++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.++#### File Download Request++```bash+curl --location 'https://backend.composio.dev/api/v3/tools/execute/proxy' \+ --header 'accept: application/json' \+ --header 'x-api-key: <YOUR_API_KEY>' \+ --header 'Content-Type: application/json' \+ --data '{+ "endpoint": "{YOUR_ENDPOINT}",+ "method": "GET",+ "connected_account_id": "{YOUR_CONNECTED_ACCOUNT_ID}"+ }'+```++#### File Download Response++```json+{+ "data": {},+ "binary_data": {+ "url": "url to the file",+ "content_type": "content type of the file",+ "size": "size of the file",+ "expires_at": "expires at of the file"+ },+ "status": "status code of the response",+ "headers": "headers of the response"+}+```++### Summary++| Feature | Field | Description |+|---------|-------|-------------|+| File Upload via URL | `binary_body.url` | Provide a URL pointing to the file to upload |+| File Upload via Base64 | `binary_body.base64` + `binary_body.content_type` | Provide base64-encoded content (up to 4MB) |+| File Download | `binary_data` in response | Receive a signed URL to download binary responses |++We'd love your feedback on the new proxy execute capabilities. If anything feels unclear or you have suggestions for improvement, please reach out.