Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | --- |
| 2 | title: Files |
| 3 | description: "File management" |
| 4 | --- |
| 5 | |
| 6 | {/* Auto-generated from OpenAPI spec. Edit the overview at api-overviews/files.mdx, not this file. */} |
| 7 | |
| 8 | These endpoints handle files that tools read and write during execution. When a tool produces or consumes a file, Composio stores it in object storage and exchanges it through presigned URLs rather than streaming bytes through the API. |
| 9 | |
| 10 | You reach for these endpoints to: |
| 11 | |
| 12 | - **List files** that tools have generated, optionally filtered by app and action. |
| 13 | - **Request an upload**: get a presigned S3 URL, `PUT` your file to it, then pass the returned reference into a tool's input. |
| 14 | |
| 15 | This keeps large payloads out of request bodies. Tools receive a file reference and resolve the underlying object on their side. |
| 16 | |
| 17 | <Callout type="info"> |
| 18 | File uploads are a two-step flow. Call the upload-request endpoint to mint a presigned URL, then upload the file contents directly to that URL. The API never receives the raw bytes. |
| 19 | </Callout> |
| 20 | |
| 21 | If your agent works with files inside a session, prefer the session file mount, where the sandbox exposes uploaded files to running code. See the [remote sandbox](/docs/sandbox/remote) for the sandbox helpers (`upload_local_file`, `smart_file_extract`) that build on this storage. |
| 22 | |
| 23 | These endpoints use your project API key in the `x-api-key` header. |
| 24 | |
| 25 | ## Endpoints |
| 26 | |
| 27 | <ApiEndpointsTable endpoints={[{"method":"GET","pathV31":"/api/v3.1/files/list","pathV3":"/api/v3/files/list","summary":"List files with optional app and action filters (DEPRECATED)","href":"/reference/api-reference/files/getFilesList","legacy":true},{"method":"POST","pathV31":"/api/v3.1/files/upload/request","pathV3":"/api/v3/files/upload/request","summary":"Create presigned URL for request file upload to S3","href":"/reference/api-reference/files/postFilesUploadRequest"}]} /> |