Skip to main content
POST
Create a presigned upload URL for a mount file

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Path Parameters

session_id
string<toolRouterSessionId>
required

The unique identifier of the tool router session

Example:

"trs_1a2b3c4d5e6f"

mount_id
string
required

ID of the storage mount

Minimum string length: 1
Example:

"files"

Body

application/json
mount_relative_path
string
required

Supports subdirectories (e.g. "data/output.csv", "images/charts/chart.png")

Minimum string length: 1
Example:

"report.pdf"

mimetype
string

MIME type of the file being uploaded

Minimum string length: 1
Example:

"application/pdf"

Response

Upload URL created successfully

upload_url
string
required

Presigned upload URL — PUT the file content here

mount_relative_path
string
required

Relative file path within the mount (e.g. "report.pdf")

sandbox_mount_prefix
string
required

Absolute mount path inside the sandbox (e.g. /mnt/files)

expires_at
string
required

ISO 8601 timestamp when the upload URL expires